--- title: "Retrieve a Card" method: GET path: "/cards/{card_id}" --- # Retrieve a Card `GET /cards/{card_id}` ## Path parameters - `card_id` string, required — The identifier of the Card. ## Response `200` Card - Card — Cards may operate on credit, debit, or prepaid BINs. They’ll immediately work for online purchases after you create them. All cards work on a good funds model, and maintain a maximum limit of 100% of the Account’s available balance at the time of transaction. Funds are deducted from the Account upon transaction settlement. - `account_id` string, required — The identifier for the account this card belongs to. - `authorization_controls` object, nullable, required — Controls that restrict how this card can be used. - `merchant_acceptor_identifier` object, nullable, required — Restricts which Merchant Acceptor IDs are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required — The Merchant Acceptor IDs that are allowed for authorizations on this card. - `identifier` string, required — The Merchant Acceptor ID. - `blocked` object[], nullable, required — The Merchant Acceptor IDs that are blocked for authorizations on this card. - `identifier` string, required — The Merchant Acceptor ID. - `merchant_category_code` object, nullable, required — Restricts which Merchant Category Codes are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required — The Merchant Category Codes that are allowed for authorizations on this card. - `code` string, required — The Merchant Category Code (MCC). - `blocked` object[], nullable, required — The Merchant Category Codes that are blocked for authorizations on this card. - `code` string, required — The Merchant Category Code (MCC). - `merchant_country` object, nullable, required — Restricts which merchant countries are allowed or blocked for authorizations on this card. - `allowed` object[], nullable, required — The merchant countries that are allowed for authorizations on this card. - `country` string, required — The ISO 3166-1 alpha-2 country code. - `blocked` object[], nullable, required — The merchant countries that are blocked for authorizations on this card. - `country` string, required — The ISO 3166-1 alpha-2 country code. - `usage` object, nullable, required — Controls how many times this card can be used. - `category` 'single_use' | 'multi_use', required — Whether the card is for a single use or multiple uses. - `multi_use` object, nullable, required — Controls for multi-use cards. Required if and only if `category` is `multi_use`. - `spending_limits` object[], nullable, required — Spending limits for this card. The most restrictive limit applies if multiple limits match. - `interval` 'all_time' | 'per_transaction' | 'per_day' | 'per_week' | 'per_month', required — The interval at which the spending limit is enforced. - `merchant_category_codes` object[], nullable, required — The Merchant Category Codes (MCCs) this spending limit applies to. If not set, the limit applies to all transactions. - `code` string, required — The Merchant Category Code (MCC). - `settlement_amount` integer, required — The maximum settlement amount permitted in the given interval. - `single_use` object, nullable, required — Controls for single-use cards. Required if and only if `category` is `single_use`. - `settlement_amount` object, required — The settlement amount constraint for this single-use card. - `comparison` 'equals' | 'less_than_or_equals', required — The operator used to compare the settlement amount. - `value` integer, required — The settlement amount value. - `billing_address` object, required — The Card's billing address. - `city` string, nullable, required — The city of the billing address. - `line1` string, nullable, required — The first line of the billing address. - `line2` string, nullable, required — The second line of the billing address. - `postal_code` string, nullable, required — The postal code of the billing address. - `state` string, nullable, required — The US state of the billing address. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created. - `description` string, nullable, required — The card's description for display purposes. - `digital_wallet` object, nullable, required — 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. - `digital_card_profile_id` string, nullable, required — The digital card profile assigned to this digital card. Card profiles may also be assigned at the program level. - `email` string, nullable, required — An email address that can be used to verify the cardholder via one-time passcode over email. - `phone` string, nullable, required — A phone number that can be used to verify the cardholder via one-time passcode over SMS. - `entity_id` string, nullable, required — The identifier for the entity associated with this card. - `expiration_month` integer, required — The month the card expires in M format (e.g., August is 8). - `expiration_year` integer, required — The year the card expires in YYYY format (e.g., 2025). - `id` string, required — The card identifier. - `idempotency_key` string, nullable, required — 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). - `last4` string, required — The last 4 digits of the Card's Primary Account Number. - `status` 'active' | 'disabled' | 'canceled', required — This indicates if payments can be made with the card. - `type` 'card', required — A constant representing the object's type. For this resource it will always be `card`. ## Other responses - `4XX` — Error - `5XX` — Error --- [API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)