GET
/
customers
/
{customerID}
/
card_accounts
/
{cardAccountID}
Retrieve a card account
curl --request GET \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID} \
  --header 'Api-Key: <api-key>'
{
  "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

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

Response

The retrieved 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[]