Create Utilization Proof

Submit a utilization proof record with supporting documents. The request uses multipart/form-data. The data field must be a JSON-encoded string containing the utilization payload. Each proof document is attached as a separate file field named after the route or corridor it belongs to (e.g. settlement_<routeId>, payment_<corridorId>).

POST /api/v2/liquidity/utilization/proofs

Create Utilization Proof

cURL

curl --request POST \
  --url https://api.mansa.xyz/api/v2/liquidity/utilization/proofs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'data=<string>' \
  --form additionalProperties='@example-file'

201

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "currency": "<string>",
  "corridors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "routes": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ]
    }
  ],
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

x-api-key · string · header · required

API key for authentication

Authorization · string · header · required

JWT token following RFC001 specification

Body

multipart/form-data

data · string · required

JSON-encoded CreateUtilizationRequest object.

{key} · file

Optional proof document files, named after the route or corridor they belong to.

Response

201

application/json

Utilization proof created successfully

id · string<uuid>

amount · number

currency · string

corridors · object[]

Show child attributes

created_at · string<date-time>