Create Withdrawal

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 30000,
  "symbolOrigin": "COPM",
  "symbolDestination": "COP",
  "paymentMethod": "BANK_TRANSFER",
  "originId": "{{wallet_id}}",
  "destinationId": "{{destination_account_id}}"
}
'

import requests

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

payload = {
    "amount": 30000,
    "symbolOrigin": "COPM",
    "symbolDestination": "COP",
    "paymentMethod": "BANK_TRANSFER",
    "originId": "{{wallet_id}}",
    "destinationId": "{{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: 30000,
    symbolOrigin: 'COPM',
    symbolDestination: 'COP',
    paymentMethod: 'BANK_TRANSFER',
    originId: '{{wallet_id}}',
    destinationId: '{{destination_account_id}}'
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal', 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 Withdrawal

Creates a withdrawal: moves funds from one of the user’s wallets (originId) to a registered destination, converting between assets when needed (for example USDC → COP to a bank account).

Request

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

Request Body

Field	Type	Required	Description
amount	number	Yes	Amount to withdraw, in `symbolOrigin`.
originId	uuid	Yes	Wallet the funds come from (`walletId` from GET /admin/wallets/{user_id}).
destinationId	uuid	No	Registered, `APPROVED` bank account or wallet that receives the funds.
symbolOrigin	string	No	Asset debited (e.g. `USDC`, `COPM`).
symbolDestination	string	No	Asset delivered (e.g. `COP`, `USD`).
paymentMethod	string	No	Rail: `BANK_TRANSFER`, `BREB`, `ACH`, `WIRE`, `SWIFT` or `ACH_WIRE`. Defaults to `PSE`.
executionMode	string	No	`NORMAL` (default, `amount` is what you send) or `INVERSE` (`amount` is what the destination receives).
quoteId	uuid	No	Quote from POST /admin/operations/custodian-quote to lock its rate.
currency	string	No	Fiat currency of the destination.
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}

withdrawal

Create Withdrawal

curl --request POST \
  --url https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 30000,
  "symbolOrigin": "COPM",
  "symbolDestination": "COP",
  "paymentMethod": "BANK_TRANSFER",
  "originId": "{{wallet_id}}",
  "destinationId": "{{destination_account_id}}"
}
'

import requests

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

payload = {
    "amount": 30000,
    "symbolOrigin": "COPM",
    "symbolDestination": "COP",
    "paymentMethod": "BANK_TRANSFER",
    "originId": "{{wallet_id}}",
    "destinationId": "{{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: 30000,
    symbolOrigin: 'COPM',
    symbolDestination: 'COP',
    paymentMethod: 'BANK_TRANSFER',
    originId: '{{wallet_id}}',
    destinationId: '{{destination_account_id}}'
  })
};

fetch('https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal', 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

originId

string

destinationId

string

Response

200 - application/json

operation

object

Show child attributes

tierEscalation

any

Guides

API reference

Create Withdrawal

Request

Request Body

Response

Errors

Authorizations

Path Parameters

Body

Response