Skip to main content
GET
/
v2
/
cards
List cards
curl --request GET \
  --url https://thirdparty.qonto.com/v2/cards \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 11,
    "total_count": 210,
    "per_page": 20
  },
  "cards": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "nickname": "💳 for 🍗",
      "embossed_name": "DOLORES KOULECHOV",
      "status": "pending",
      "pin_set": true,
      "mask_pan": "511768******7662",
      "exp_month": "3",
      "exp_year": "2024",
      "last_activity_at": "2023-11-07T05:31:56Z",
      "last_digits": "7662",
      "ship_to_business": false,
      "atm_option": true,
      "nfc_option": true,
      "online_option": true,
      "foreign_option": true,
      "atm_monthly_limit": 1000,
      "atm_monthly_spent": 1000,
      "atm_daily_limit": 1000,
      "atm_daily_spent": 0,
      "atm_daily_limit_option": true,
      "payment_monthly_limit": 1000,
      "payment_monthly_spent": 1000,
      "payment_daily_limit": 1000,
      "payment_daily_spent": 1000,
      "payment_daily_limit_option": true,
      "payment_transaction_limit": 1000,
      "payment_transaction_limit_option": true,
      "active_days": [
        1,
        3,
        5
      ],
      "holder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bank_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "shipped_at": null,
      "card_type": "debit",
      "card_level": "standard",
      "payment_lifespan_limit": 100,
      "payment_lifespan_spent": 42,
      "pre_expires_at": "2023-11-07T05:31:56Z",
      "categories": [
        "transport",
        "restaurant_and_bar",
        "food_and_grocery"
      ],
      "renewed": false,
      "renewal": false,
      "parent_card_summary": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "last_digits": "7662"
      },
      "had_operation": false,
      "had_pin_operation": false,
      "card_design": "standard.recycled.plastic.2023",
      "type_of_print": "embossed",
      "upsold": false,
      "upsell": false,
      "discard_on": "2022-11-31",
      "reordered": false,
      "appearance": {
        "assets": {
          "front_large": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_large.png",
          "front_small": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_small.png",
          "front_small_wallet": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_small_wallet.png"
        },
        "theme": "dark",
        "gradient_hex_color": "#000000"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

​
query
string

Text search can be performed on the following fields:

  • memberships.first_name
  • memberships.last_name
  • cards.id
  • cards.nickname
  • cards.last_digits
  • cards.status
  • cards.pre_expires_at
  • cards.exp_year
  • cards.exp_month
​
page
integer
default:1

Returned page (cf. Pagination).

Example:

2

​
per_page
integer
default:100

Number of cards per page (cf. Pagination).

Required range: x <= 100
Example:

20

​
sort_by
string<property:order>
default:status:asc

Cards can be sorted by a specific property and order. Property: status, nickname, last_activity_at or created_at Order: asc (Ascending) / desc (Descending)

​
holder_ids[]
string<uuid>[]

Cards can be filtered by their holder_id.

The membership identifier of the card holder.

​
statuses[]
enum<string>[]

Cards can be filtered by their status.

Example:

"statuses[]=pending&statuses[]=live"

​
bank_account_ids[]
string<uuid>[]

Cards can be filtered by their bank_account_id.

The id of the bank account to which the card is attached

Example:

"bank_account_ids[]=id1&bank_account_ids[]=id2"

​
card_levels[]
enum<string>[]

Cards can be filtered by their card_level.

Example:

"card_levels[]=virtual&card_levels[]=flash"

​
ids[]
string<uuid>[]

Cards can be filtered by their id.

Unique card identifier

Example:

"ids[]=id1&ids[]=id2"

Response

Returns the list of cards.

​
meta
object

Metadata for paginated responses

​
cards
object[]