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": null,
"prev_page": 1,
"total_pages": 2,
"total_count": 150,
"per_page": 100
},
"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
}
]
}

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.<br>👉 Property: status, nickname, last_activity_at or created_at<br>👉 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

200
application/json

Returns the list of cards.

The response is of type object.