Cards Report

Last updated: January 22, 2025

The Cards Report lists all your cards during a specified period. It provides information about:

The card type, card product, and card details
The cardholder
The card's status

The report is provided as a CSV file. By default, the file name uses the following format:

issuing_cards_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv

The report data is refreshed daily at 01:00:00 UTC.

See instructions on how to download the report on demand or on a schedule:

Download a sample report (CSV file).

Information

If using Safari, hold down the Option key when selecting the link to download the file.

The report includes all the following fields in this order:

Field name Description

Field name	Description
Card ID string	The unique identifier for the card. Example – `crd_abcdef1ghijklmn23opq45r6st`
Cardholder ID string	The unique identifier for the cardholder. Example – `crh_abcdef1ghijklmn23opq45r6st`
Card Product ID string	The identifier for the card product, which represents the configuration that your card inherits. Example – `pro_abcdef1ghijklmn23opq45r6st`
Entity ID string	The unique identifier for your Checkout.com entity. Example – `ent_abcdef1ghijklmn23opq45r6st`
Client ID string	Your unique identifier from Checkout.com. Example – `cli_abcdef1ghijklmn23opq45r6st`
Type string	The type of card. This can be one of: `physical_card` – A physical card `multiple_use_virtual_card` – A reusable non-physical card for card-not-present (CNP) transactions only `single_use_virtual_card` – A non-reusable non-physical card for CNP transactions only
Status string	The current status of the card. This can be one of: `active` – The card is activated and not subject to any restrictions. `inactive` – The card is awaiting activation. `revoked` – You have canceled the card and all incoming authorizations will be declined. `suspended` – You have frozen the card and all transactions will be declined.
Expiry Date datetime	The date when the card expires. Format – `MM/YYYY` Examples – `9/2025`, `11/2029`
Masked PAN string	The masked primary account number (PAN) for the card. Example – `1234 56 ** 7890`
Billing Currency string	The currency you bill the cardholder in. Format – ISO 4217 code
Issuing Country string	The country you issued the card in. Format – ISO alpha-3 country code
Display Name string	The display name you provided when creating the card.
Reference string	The identification reference you provided when creating the card.
Card UDF 1 string	A user-defined field you specified during setup.
Card UDF 2 string	A user-defined field you specified during setup.
Card UDF 3 string	A user-defined field you specified during setup.
Card UDF 4 string	A user-defined field you specified during setup.
Card UDF 5 string	A user-defined field you specified during setup.
Created On datetime	The date and time when you created this card in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`
Last Changed On datetime	The date and time when you last updated the card in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`

Card ID

string

The unique identifier for the card.
Example – crd_abcdef1ghijklmn23opq45r6st

Cardholder ID

string

The unique identifier for the cardholder.
Example – crh_abcdef1ghijklmn23opq45r6st

Card Product ID

string

The identifier for the card product, which represents the configuration that your card inherits.
Example – pro_abcdef1ghijklmn23opq45r6st

Entity ID

string

The unique identifier for your Checkout.com entity.
Example – ent_abcdef1ghijklmn23opq45r6st

Client ID

string

Your unique identifier from Checkout.com.
Example – cli_abcdef1ghijklmn23opq45r6st

Type

string

The type of card. This can be one of:

physical_card – A physical card
multiple_use_virtual_card – A reusable non-physical card for card-not-present (CNP) transactions only
single_use_virtual_card – A non-reusable non-physical card for CNP transactions only

Status

string

The current status of the card. This can be one of:

active – The card is activated and not subject to any restrictions.
inactive – The card is awaiting activation.
revoked – You have canceled the card and all incoming authorizations will be declined.
suspended – You have frozen the card and all transactions will be declined.

Expiry Date

datetime

The date when the card expires.
Format – MM/YYYY
Examples – 9/2025, 11/2029

Masked PAN

string

The masked primary account number (PAN) for the card.
Example – 1234 56** **** 7890

Billing Currency

string

The currency you bill the cardholder in.
Format – ISO 4217 code

Issuing Country

string

The country you issued the card in.
Format – ISO alpha-3 country code

Display Name

string

The display name you provided when creating the card.

Reference

string

The identification reference you provided when creating the card.

Card UDF 1

string