--- title: "List Cards" method: GET path: "/cards" --- # List Cards `GET /cards` ## Query parameters - `cursor` string — Return the page of entries after this one. - `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects. - `account_id` string — Filter Cards to ones belonging to the specified Account. - `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp. - `status.in` string[] — Filter Cards by status. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`. - `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that 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). ## Response `200` Card List - CardList — A list of Card objects. - `data` Card[], required — The contents of the list. - `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. - … - `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. - `bin` string, required — The Bank Identification Number (BIN) of the Card. - `cardholder_name` object, nullable, required — The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations. - `first` string, required — The cardholder's first name. - `last` string, required — The cardholder's last name. - `middle` string, nullable, required — The cardholder's middle name. - `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`. - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`. ## Other responses - `4XX` — Error - `5XX` — Error --- [API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)