Skip to main content
POST
/
customers
/
{customerID}
/
card_accounts
/
{cardAccountID}
/
withdrawals
Create a funds withdrawal request
curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/withdrawals \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "amount": "<string>",
  "type": "top_up_balance_withdrawal",
  "destination": {
    "chain": "<string>",
    "address": "<string>",
    "memo": "<string>",
    "gas_fee": {}
  },
  "client_note": "<string>"
}'
{
  "id": "<string>",
  "amount": "<string>",
  "type": "top_up_balance_withdrawal",
  "currency": "usdc",
  "destination": {
    "chain": "<string>",
    "address": "<string>",
    "memo": "<string>",
    "tx_hash": "<string>",
    "gas_fee": {
      "amount": "<string>",
      "currency": "<string>"
    }
  },
  "client_note": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

​
Api-Key
string
header
required

Headers

​
Idempotency-Key
string
required

Path Parameters

​
customerID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
​
cardAccountID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Body

application/json

The withdrawal request

A card funds withdrawal

​
id
string
required

ID of the withdrawal

Required string length: 1 - 42
​
amount
string
required

The amount represented as a decimal string

​
currency
enum<string>
required

The currency of the withdrawal, which is the crypto currency on the card account

Available options:
usdc
​
destination
object
required
​
type
enum<string>

The type of the withdrawal. Defaults to top_up_balance_withdrawal.

Available options:
top_up_balance_withdrawal,
fee
​
client_note
string

An optional client-provided note for the withdrawal

Response

The successfully created card funds withdrawal

A card funds withdrawal

​
id
string
required

ID of the withdrawal

Required string length: 1 - 42
​
amount
string
required

The amount represented as a decimal string

​
currency
enum<string>
required

The currency of the withdrawal, which is the crypto currency on the card account

Available options:
usdc
​
destination
object
required
​
created_at
string
required

Timestamp when the withdrawal was created, in ISO8601 format

​
updated_at
string
required

Timestamp when the withdrawal was last updated, in ISO8601 format

​
type
enum<string>

The type of the withdrawal. Defaults to top_up_balance_withdrawal.

Available options:
top_up_balance_withdrawal,
fee
​
client_note
string

An optional client-provided note for the withdrawal