Sign in

v1

latestOpenAPI 3.0.12026-07-26106359429.8 KB
Compliance

Retrieve a card by client card ID

Beta: This endpoint is in beta and may change before general availability.

Retrieves a card by the client_card_id you assigned, supplied as a query parameter: GET /v0/cards?client_card_id=.... This is the filtered form of the cards collection and is distinct from GET /v0/cards/{id}, which takes the server-generated Card ID (card_*). The response body is identical to GET /v0/cards/{id}.

get/v0/cards

Query parameters

client_card_idstring required

The client_card_id assigned to the card.

Response

Card object retrieved successfully.

idstring

The server-generated ID of the Card object.

client_card_idstring

Client-provided identifier for the card. Optional: present only for cards created via file upload, and omitted for cards created through the API, which are identified solely by their server-generated ID.

account_idstring

The ID of the Account object.

entity_idstring

The ID of your entity.

status'active' | 'inactive' | 'closed'

Status is system-managed and cannot be set on create; status changes go through the status-transition endpoints.

status_reasonstring

The reason for the card's current status. Empty when the card is active; otherwise populated. Set via the status-transition endpoints.

created_atstring date-time

Creation timestamp.

updated_atstring date-time

Last update timestamp.

metadataMetadata

A set of key-value pairs that can be used to store additional information related to this object.

Example response

{
  "id": "card_xyz123",
  "account_id": "account_xyz123",
  "entity_id": "entity_xyz123",
  "details": {
    "last_four": "1234",
    "replacement_for": "card_xyz123"
  }
}