---
title: "Create Send Transaction"
method: POST
path: "/sends"
tags: ["Transactions"]
---

# Create Send Transaction

`POST /sends`

Initiate a send transaction from vault.

## Request body

- object
  - `token` string, required — The stablecoin identifier to transfer (e.g. USDT_TRC20, USDC_SOL).
  - `vaultId` string, required — The unique ID of the originating vault from which funds will be withdrawn. USD_BALANCE is also acceptable here, to transfer from USD float balance to destination vault.
  - `amount` integer, required — The transfer amount.
  - `sequenceId` string, required — A unique client-generated reference used to ensure idempotency and prevent duplicate transfers.
  - `destination` object, required — The destination details for the transfer. The structure varies depending on transfer type (on-chain, internal vault, etc.).
    - `type` 'USD_BALANCE' | 'INTERNAL' | 'EXTERNAL', required — INTERNAL is used when transferring from one vault to another vault. EXTERNAL is used when transferring to external wallet addresses. USD_BALANCE is used when topping up USD Float balance from a vault.
    - `address` string, required — The blockchain wallet address.
    - `vaultId` string — The internal vault ID to transfer funds to. Only required if INTERNAL.
  - `countryCode` string, required — Recipient country code. e.g. NG
  - `travelRuleData` string, required — Travel rule data based on travel rule config for recipient country code.

## Response `201`

Create Send Transaction

- object
  - `name` string — id
  - `sequenceId` string
  - `partnerId` string
  - `amount` integer
  - `networkFee` integer
  - `token` string
  - `currency` string
  - `network` string
  - `type` string
  - `status` string
  - `destinationAddress` string
  - `destinationType` string
  - `destinationVaultId` string
  - `sourceAddress` string
  - `sourceVaultId` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api.md) · [All operations](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yellowcard/yellow-cards-payment-api/revisions/516d251059cc/schema)