Liquidity Ramps

Create Withdrawal

Creates a withdrawal. The origin of the funds decides the flow:

Custody (originId): the funds leave one of the user’s custody wallets.
External wallet (originExternalWalletId): an off-ramp. The user sends the stablecoin from a registered external wallet; the operation starts in AWAITING_DEPOSIT and depositInfo.depositInstructions returns the address, network, token, exact amount and expiresAt to send to. Send exactly that amount from the declared external wallet. Optionally report the transaction hash with POST /admin/operation/{user_id}/withdrawal/{operation_id}/hash.

Send exactly one of originId or originExternalWalletId.

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	One of	Custody wallet the funds come from (`id` from GET /admin/wallets/{user_id}).
originExternalWalletId	uuid	One of	Registered, `APPROVED` external wallet the user sends the funds from (off-ramp).
destinationId	uuid	Yes with `originExternalWalletId`	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`. Must be a rail your account pays out (for example, an account paying out in USD only accepts `ACH`, `WIRE` or `SWIFT`).
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.

Off-ramp body example:

{
    "amount": 20,
    "symbolOrigin": "USDC",
    "symbolDestination": "COP",
    "paymentMethod": "BANK_TRANSFER",
    "originExternalWalletId": "{{external_wallet_id}}",
    "destinationId": "{{destination_account_id}}"
}

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 wallet (custody mode only; the external-wallet mode does not check balance).
403	The user does not exist or is not `APPROVED`.
422	Invalid body (both or neither of `originId` / `originExternalWalletId`), amount ≤ 0, payment method your account cannot pay out, 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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 30000,
    'symbolOrigin' => 'COPM',
    'symbolDestination' => 'COP',
    'paymentMethod' => 'BANK_TRANSFER',
    'originId' => '{{wallet_id}}',
    'destinationId' => '{{destination_account_id}}'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}"

response = http.request(request)
puts response.read_body

{
  "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

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));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 30000,
    'symbolOrigin' => 'COPM',
    'symbolDestination' => 'COP',
    'paymentMethod' => 'BANK_TRANSFER',
    'originId' => '{{wallet_id}}',
    'destinationId' => '{{destination_account_id}}'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://test-api-kore.kravata.co/api/v1/admin/operation/{user_id}/withdrawal")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 30000,\n  \"symbolOrigin\": \"COPM\",\n  \"symbolDestination\": \"COP\",\n  \"paymentMethod\": \"BANK_TRANSFER\",\n  \"originId\": \"{{wallet_id}}\",\n  \"destinationId\": \"{{destination_account_id}}\"\n}"

response = http.request(request)
puts response.read_body

{
  "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
}

Guides

API reference

Create Withdrawal

Request

Request Body

Response

Errors

Authorizations

Path Parameters

Body

Response