Skip to main content
POST
/
v0
/
disbursements
Create a disbursement
curl --request POST \
  --url https://api-sandbox.superbank.co/v0/disbursements \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "wallet_address": "74JFqeuZDJwVzEhHvX1Cn5Ld1ioApqBNWNNgnMhj164j",
  "amount": "1000.00",
  "currency": "USDC"
}
'
{
  "id": "d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a",
  "destination_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "amount": "1000.00",
  "currency": "USDC",
  "status": "PENDING",
  "created_at": "2026-01-20T15:17:12.805Z",
  "updated_at": "2026-01-20T15:20:00.000Z",
  "payment_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "failure_reason": {},
  "completed_at": "2026-01-20T15:25:00.000Z"
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
wallet_address
string
required

The wallet address of a verified (whitelisted) destination

Example:

"74JFqeuZDJwVzEhHvX1Cn5Ld1ioApqBNWNNgnMhj164j"

​
amount
string
required

The amount to disburse

Example:

"1000.00"

​
currency
string
required

The currency of the disbursement

Example:

"USDC"

Response

​
id
string
required
Example:

"d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a"

​
destination_id
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
amount
string
required
Example:

"1000.00"

​
currency
string
required
Example:

"USDC"

​
status
enum<string>
required
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
Example:

"PENDING"

​
created_at
string
required
Example:

"2026-01-20T15:17:12.805Z"

​
updated_at
string
required
Example:

"2026-01-20T15:20:00.000Z"

​
payment_id
object
Example:

"f1e2d3c4-b5a6-7890-abcd-ef1234567890"

​
failure_reason
object
​
completed_at
object
Example:

"2026-01-20T15:25:00.000Z"