Sign in
Cards

Create a funds withdrawal request

Request a funds withdrawal from the card account, applicable to top-up accounts only. For Bridge wallets, create a transfer from the Bridge wallet.

post/customers/{customerID}/card_accounts/{cardAccountID}/withdrawals

Path parameters

customerIDstring required

A UUID that uniquely identifies a resource

cardAccountIDstring required

A UUID that uniquely identifies a resource

Headers

Idempotency-Keystring required

Request body

idstring required

A UUID that uniquely identifies a resource

card_account_idstring required

A UUID that uniquely identifies a resource

customer_idstring required

A UUID that uniquely identifies a resource

amountstring required

The amount represented as a decimal string

type'top_up_balance_withdrawal' | 'fee'

The type of the withdrawal. Defaults to top_up_balance_withdrawal.

currency'usdc' required
client_notestring

An optional client-provided note for the withdrawal

created_atstring required

Timestamp when the withdrawal was created, in ISO8601 format

updated_atstring required

Timestamp when the withdrawal was last updated, in ISO8601 format

Response

The successfully created card funds withdrawal

idstring required

A UUID that uniquely identifies a resource

card_account_idstring required

A UUID that uniquely identifies a resource

customer_idstring required

A UUID that uniquely identifies a resource

amountstring required

The amount represented as a decimal string

type'top_up_balance_withdrawal' | 'fee'

The type of the withdrawal. Defaults to top_up_balance_withdrawal.

currency'usdc' required
client_notestring

An optional client-provided note for the withdrawal

created_atstring required

Timestamp when the withdrawal was created, in ISO8601 format

updated_atstring required

Timestamp when the withdrawal was last updated, in ISO8601 format