Create Off-Ramp

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 12,
  "symbolOrigin": "USDC",
  "symbolDestination": "COP",
  "paymentMethod": "BANK_TRANSFER",
  "originExternalWalletId": "{{external_wallet_id}}",
  "destinationAccountId": "{{destination_account_id}}"
}
'

import requests

url = "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp"

payload = {
    "amount": 12,
    "symbolOrigin": "USDC",
    "symbolDestination": "COP",
    "paymentMethod": "BANK_TRANSFER",
    "originExternalWalletId": "{{external_wallet_id}}",
    "destinationAccountId": "{{destination_account_id}}"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 12,
    symbolOrigin: 'USDC',
    symbolDestination: 'COP',
    paymentMethod: 'BANK_TRANSFER',
    originExternalWalletId: '{{external_wallet_id}}',
    destinationAccountId: '{{destination_account_id}}'
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "operation": {
    "id": "567e0559-2301-42ab-a865-d8763dea3888",
    "userId": "c9a26b49-7b71-44e5-8fdf-03ec6a2a7267",
    "type": "CUSTODY",
    "custodyType": "SELF_CUSTODY",
    "prefix": "NPO",
    "numberCode": 96545,
    "originId": "5c3fa520-adbb-49aa-a95b-018c13db79e3",
    "destinationId": "dfa1bb42-74b7-4dab-b52b-0ec2e26253db",
    "symbolOrigin": "USDC",
    "symbolDestination": "USD",
    "amountOrigin": 200,
    "amountDestination": 175,
    "rate": 1,
    "paymentMethod": "WIRE",
    "registerDate": "2026-06-23T09:32:10.944107",
    "status": "PENDING",
    "direction": "WITHDRAWAL",
    "depositInstructions": null,
    "metadataItems": null,
    "events": null,
    "treasuryItems": [
      {
        "id": "b733d7d8-5162-4dc9-a786-422265d0bfa5",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "realRate",
        "amount": 1,
        "showClient": false
      },
      {
        "id": "9f9b6abc-09d9-4a78-b4a6-8991f2979be0",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "MinAmount",
        "amount": 50,
        "showClient": false
      },
      {
        "id": "fb0d7a71-739c-40a9-abbc-6089c4149d4c",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "CostInfra",
        "amount": 25,
        "showClient": true
      },
      {
        "id": "e6c08f41-78c2-4c6b-b7e9-f6bbd6fc4f21",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "spread",
        "amount": 0,
        "showClient": false
      },
      {
        "id": "842f57f1-44aa-46ea-84ea-2b5c8524135a",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "calculateRate",
        "amount": 1,
        "showClient": true
      },
      {
        "id": "85c17fc1-aaed-4351-be64-1046dedd867b",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "amountReceive",
        "amount": 175,
        "showClient": true
      }
    ]
  },
  "tierEscalation": null
}

Liquidity Ramps

Create Off-Ramp

Creates an off-ramp: the user sends stablecoin from a registered external wallet and receives fiat in a registered bank account. The operation starts in AWAITING_DEPOSIT until the funds arrive; the deposit instructions are returned in the response.

Request

Field	Type	Required	Description
Authorization	Header	Yes	`Bearer <access_token>` obtained from POST /api/v1/client/token.
user_id	Path	Yes	User who sends and receives the funds.

Request Body

Field	Type	Required	Description
amount	number	Yes	Amount of the operation, in `symbolOrigin`.
originExternalWalletId	uuid	Yes	Registered external wallet the funds will come from.
destinationAccountId	uuid	Yes	Registered, `APPROVED` bank account that receives the fiat.
symbolOrigin	string	No	Stablecoin sent (e.g. `USDC`).
symbolDestination	string	No	Fiat delivered (e.g. `COP`).
paymentMethod	string	No	Rail used to pay out the fiat (e.g. `BANK_TRANSFER`, `BREB`).
currency	string	No	Fiat currency of the destination.
executionMode	string	No	`NORMAL` (default) or `INVERSE`.
developerFee	number	No	Additional fee you charge your user.

Response

The response is an envelope with three keys:

Field	Description
operation	The created operation: `id`, `userId`, `numberCode`, `originId`, `destinationId`, `symbolOrigin`, `symbolDestination`, `amountOrigin`, `amountDestination`, `rate`, `paymentMethod`, `status`, `direction`, `registerDate`, `depositInstructions`, `treasuryItems` (cost breakdown) and `events`.
tierEscalation	`null` when the operation fits the user’s current compliance tier. Otherwise it describes the action the user must complete to raise their limits (`actionType`: `FORM_URL`, `QR_APP`, `VIDEO_KYC`, `DOC_UPLOAD`, `NOTIFY_ONLY` or `BLOCK`, plus `actionPayload`, `message` and `expiresAt`).
depositInfo	Present when the user has to send funds: `paymentMethod`, the applied `quote` and the `depositInstructions`. `null` otherwise.

Errors

Status	When
400	Insufficient funds in the origin.
403	The user does not exist or is not `APPROVED`.
422	Invalid body, amount ≤ 0, asset pair not enabled for your account, destination not registered/approved/owned by the user, or the operation exceeds the user’s compliance tier limits.

POST

api

admin

operation

{user_id}

offramp

Create Off-Ramp

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 12,
  "symbolOrigin": "USDC",
  "symbolDestination": "COP",
  "paymentMethod": "BANK_TRANSFER",
  "originExternalWalletId": "{{external_wallet_id}}",
  "destinationAccountId": "{{destination_account_id}}"
}
'

import requests

url = "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp"

payload = {
    "amount": 12,
    "symbolOrigin": "USDC",
    "symbolDestination": "COP",
    "paymentMethod": "BANK_TRANSFER",
    "originExternalWalletId": "{{external_wallet_id}}",
    "destinationAccountId": "{{destination_account_id}}"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 12,
    symbolOrigin: 'USDC',
    symbolDestination: 'COP',
    paymentMethod: 'BANK_TRANSFER',
    originExternalWalletId: '{{external_wallet_id}}',
    destinationAccountId: '{{destination_account_id}}'
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/offramp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "operation": {
    "id": "567e0559-2301-42ab-a865-d8763dea3888",
    "userId": "c9a26b49-7b71-44e5-8fdf-03ec6a2a7267",
    "type": "CUSTODY",
    "custodyType": "SELF_CUSTODY",
    "prefix": "NPO",
    "numberCode": 96545,
    "originId": "5c3fa520-adbb-49aa-a95b-018c13db79e3",
    "destinationId": "dfa1bb42-74b7-4dab-b52b-0ec2e26253db",
    "symbolOrigin": "USDC",
    "symbolDestination": "USD",
    "amountOrigin": 200,
    "amountDestination": 175,
    "rate": 1,
    "paymentMethod": "WIRE",
    "registerDate": "2026-06-23T09:32:10.944107",
    "status": "PENDING",
    "direction": "WITHDRAWAL",
    "depositInstructions": null,
    "metadataItems": null,
    "events": null,
    "treasuryItems": [
      {
        "id": "b733d7d8-5162-4dc9-a786-422265d0bfa5",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "realRate",
        "amount": 1,
        "showClient": false
      },
      {
        "id": "9f9b6abc-09d9-4a78-b4a6-8991f2979be0",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "MinAmount",
        "amount": 50,
        "showClient": false
      },
      {
        "id": "fb0d7a71-739c-40a9-abbc-6089c4149d4c",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "CostInfra",
        "amount": 25,
        "showClient": true
      },
      {
        "id": "e6c08f41-78c2-4c6b-b7e9-f6bbd6fc4f21",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "spread",
        "amount": 0,
        "showClient": false
      },
      {
        "id": "842f57f1-44aa-46ea-84ea-2b5c8524135a",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "calculateRate",
        "amount": 1,
        "showClient": true
      },
      {
        "id": "85c17fc1-aaed-4351-be64-1046dedd867b",
        "operationId": "567e0559-2301-42ab-a865-d8763dea3888",
        "name": "amountReceive",
        "amount": 175,
        "showClient": true
      }
    ]
  },
  "tierEscalation": null
}

Authorizations

Authorization

string

header

required

Access token from POST /api/v1/client/token.

Path Parameters

user_id

string<uuid>

required

Body

application/json

amount

integer

symbolOrigin

string

symbolDestination

string

paymentMethod

string

originExternalWalletId

string

destinationAccountId

string

Response

200 - application/json

operation

object

Show child attributes

tierEscalation

any

Guides

API reference

Create Off-Ramp

Request

Request Body

Response

Errors

Authorizations

Path Parameters

Body

Response