increase-test
GET/cards/{card_id}

Retrieve a card

Retrieves a Card and its account, status, and configuration details. Use this endpoint when you have the Card's identifier and need to inspect its current state. The response includes non-sensitive card details such as the BIN, last four digits, and expiration date.

1 parameter
card_idstringrequired
The identifier of the Card to retrieve.

3 status codes
200Returns the Card object, including its identifier, Account, status, BIN, last four digits, expiration month and year, billing address, and configured controls.
account_idstringrequired
The identifier for the account this card belongs to.
authorization_controlsobjectrequired
Controls that restrict how this card can be used.
billing_addressobjectrequired
The Card's billing address.
binstringrequired
The Bank Identification Number (BIN) of the Card.
cardholder_nameobjectrequired
The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created.
descriptionstringrequired
The card's description for display purposes.
digital_walletobjectrequired
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
entity_idstringrequired
The identifier for the entity associated with this card.
expiration_monthintegerrequired
The month the card expires in M format (e.g., August is 8).
expiration_yearintegerrequired
The year the card expires in YYYY format (e.g., 2025).
idstringrequired
The card identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
last4stringrequired
The last 4 digits of the Card's Primary Account Number.
statusstringrequired
This indicates if payments can be made with the card.
Allowed:activedisabledcanceled
typestringrequired
A constant representing the object's type. For this resource it will always be `card`.
Allowed:card
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the server encounters an error processing the request.

Error handling

The card_id path parameter must identify the Card to retrieve.