---
title: "List all cards"
method: GET
path: "/cards"
tags: ["Cards"]
---

# List all cards

`GET /cards`

This allows you to request a list of all cards without having to specify a relating customer. However, you do have the ability to filter using the `customer_id` parameter.

## Query parameters

- `offset` integer
- `limit` integer
- `filter` string
- `customer_id` string, uuid

## Response `200`

OK

- CardDetailedListPaged
  - `meta` object
    - `count` integer — The number of records returned as part of the response.
    - `offset` integer — The starting record number.
    - `limit` integer — The maximum number of records that can be returned as part of the response.
    - `total` integer — The total number of records contained in the query response.
    - `links` object[]
      - `rel` 'self' | 'first' | 'last' | 'prev' | 'next'
      - `href` string — Link to the resource which should be appended to base URL.
      - `title` string — Description of the link.
  - `data` CardDetailed[]
    - `card_id` string, uuid — The unique ID assigned by Acquired.com to the card when it is created.
    - `customer_id` string, uuid — The unique ID assigned by Acquired.com to the customer when it is created.
    - `card` CardMasked
      - `holder_name` string — The name of the cardholder.
      - `scheme` 'visa' | 'mastercard' | 'amex' — The scheme the card belongs to.
      - `number` string — The last 4 digits of the card number.
      - `expiry_month` integer — The month the card expires in.
      - `expiry_year` integer — The year the card expires in.
    - `bin` Bin
      - `number` string — The first 6 digits of the card number.
      - `scheme` 'visa' | 'mastercard' | 'amex' — The scheme the card belongs to.
      - `type` 'charge' | 'credit' | 'debit' | 'deferred_debit' | 'prepaid' — The type of card used in the request.
      - `product` 'consumer' | 'commercial' — The product of the card.
      - `card_level` 'aarp' | 'acquiring' | 'advantage' | 'airmiles' | 'atm_only' | 'black' | 'blue' | 'bonus' | 'business' | 'cash' | 'centurion' | 'charge_card' | 'check_card' | 'classic' | 'commerce' | 'commercial' | 'corporate' | 'delta' | 'diamond' | 'distribution' | 'electric_orange' | 'electron' | 'electronic' | 'executive_business' | 'fleet_card' | 'flying_blue' | 'gift' | 'global_payment' | 'gm_card' | 'gold' | 'government' | 'green' | 'gsa' | 'hsa_non_substantiated' | 'hsa_substantiated' | 'icard' | 'infinite' | 'interlink' | 'mastermoney' | 'new_world' | 'optima' | 'ourocard' | 'payment_card' | 'paypass_card' | 'personal' | 'pin_only' | 'platinum' | 'platinum_edge' | 'plus' | 'premier_miles' | 'premium' | 'prepaid' | 'private' | 'professional' | 'propriety' | 'purchasing' | 'q_cash' | 'quantum' | 'rebate' | 'red' | 'reserved' | 'revolving' | 'rewards' | 'salute' | 'sears' | 'signature' | 'small_business' | 'standard' | 'standard_health' | 'unembossed' | 'student' | 'titanium' | 'top_up_card' | 'traditional' | 'travel' | 'ultimate' | 'v_pay' | 'virtual' | 'world' | 'healthcare' | 'prepaid_maestro_travel' | 'maestro_delayed_debit' — The level of the card.
      - `issuer` string — The name of the bank that issued the card.
      - `issuer_country` string — The name of the country the card was issued in.
      - `issuer_country_code` string — The ISO 3166 2-character country code the card was issued in.
      - `eea` boolean — If the card was issued in the EEA.
      - `non_reloadable` boolean — If the card is a non-refundable prepaid card.
    - `source` 'card' | 'apple_pay' | 'google_pay' — Identifies how the card was created.
    - `created` string, date-time — The date and time that the customer record was created.
    - `last_updated` string, date-time — The date and time the customer record was last updated.
    - `is_active` boolean — Indicates whether a card is active or not.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)