POST
/
customers
/
{customerID}
/
card_accounts
Provision a card account
curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "client_reference_id": "<string>",
  "currency": "usdc",
  "chain": "arbitrum",
  "crypto_account": {
    "type": "standard",
    "address": "<string>"
  }
}'
{
  "id": "<string>",
  "client_reference_id": "<string>",
  "customer_id": "<string>",
  "cardholder_name": {
    "first_name": "<string>",
    "middle_name": "<string>",
    "last_name": "<string>"
  },
  "card_image_url": "<string>",
  "status": "active",
  "status_reason": "<string>",
  "card_details": {
    "last_4": "1264",
    "expiry": "10/24",
    "bin": "44325280"
  },
  "balances": {
    "available": {
      "amount": "<string>",
      "currency": "usdc"
    },
    "hold": {
      "amount": "<string>",
      "currency": "usdc"
    }
  },
  "freezes": [
    {
      "card_account_id": "<string>",
      "reason": "lost_or_stolen",
      "reason_detail": "<string>",
      "starting_at": "<string>",
      "ending_at": "<string>",
      "created_at": "<string>"
    }
  ],
  "crypto_account": {
    "type": "standard",
    "address": "<string>"
  },
  "funding_instructions": {
    "currency": "usdc",
    "chain": "arbitrum",
    "address": "<string>",
    "memo": "<string>"
  },
  "additional_funding_instructions": [
    {
      "currency": "usdc",
      "chain": "arbitrum",
      "address": "<string>",
      "memo": "<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

Body

application/json

The card account to be provisioned

​
currency
enum<string>
required

Crypto currency used by the card account being created

Available options:
usdc
​
chain
enum<string>
required

Chain used by the card account being created

Available options:
arbitrum,
avalanche_c_chain,
base,
ethereum,
optimism,
polygon,
solana,
stellar,
tron
​
client_reference_id
string

An optional client-provided reference ID that uniquely identifies the card account in the client's system

​
crypto_account
object

The crypto account for a self-custodial card account. This field is not supported for a Bridge-custodial card funding setup (note that if you are on cards trial, you are automatically on a custodial funding setup).

Response

The successfully created card account

​
id
string
required

ID of the card account

Required string length: 1 - 42
​
customer_id
string
required

ID of the customer

Required string length: 1 - 42
​
card_image_url
string
required

An expiring URL used to render the card image, with a validity period of 5 minutes

​
status
enum<string>
required

Status of the card account

Available options:
active,
pending,
inactive,
frozen
​
balances
object
required

Balances of the card account

​
freezes
object[]
required
​
client_reference_id
string

The client-provided reference ID

​
cardholder_name
object

The name of the cardholder associated to the card. By default, this will be the name of the associated customer. To override the cardholder name, you can contact Bridge support.

​
status_reason
string

An optional detailed explanation for the card account status

​
card_details
object

Details of the issued card. This object contains enough payment card details to identify the issued card, but only provides the last four digits of the card number to maintain security.

​
crypto_account
object

The crypto account for a self-custodial card account. This field is not supported for a Bridge-custodial card funding setup (note that if you are on cards trial, you are automatically on a custodial funding setup).

​
funding_instructions
object

Funding instructions applicable only to the top-up card funding strategy, which is configured at the developer level

​
additional_funding_instructions
object[]