Cards Report

Last updated: September 24, 2025

The Cards Report lists all your cards within a specified time frame. It provides information about:

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

The report data is refreshed daily at 1:00 PM UTC.

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

The report is provided as a CSV file. The file name uses the following formats by default:

API and SFTP – issuing_cards_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv
Dashboard scheduled reports – issuing_cards_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv

For SFTP, the report is uploaded in the following folder structure: {Entity_name} > reports-{Entity_name} > issuing_cards

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 card's unique identifier, prefixed with `crd_`.
Cardholder ID string	The cardholder's unique identifier, prefixed with `crh_`
Card Product ID string	The identifier for the card product, which represents the configuration that your card inherits. This is prefixed with `pro_`.
Entity ID string	The entity's unique identifier, prefixed with `ent_`.
Client ID string	Your unique identifier as a Checkout.com client, prefixed with `cli_`.
Type string	The type of card. This can be one of: `multiple_use_virtual_card` – A reusable non-physical card for card-not-present (CNP) transactions only `physical_card` – A physical card `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 date-time	The date when the card expires. Format – `MM/YYYY` Examples – `9/2025`, `11/2029`
Masked PAN string	The card's masked primary account number (PAN). Example – `1234 56 ** 7890`
Billing Currency string	The currency in which you bill the cardholder. Standard – ISO 4217 code Example – `USD`
Issuing Country string	The country where you issued the card. Standard – ISO alpha-3 country code Example – `USA`
Display Name string	The display name you provided when creating the card.
Reference string	The reference you provided when creating the card.
Card UDF 1 string	A user-defined field (UDF) you specified during setup.
Card UDF 2 string	A UDF you specified during setup.
Card UDF 3 string	A UDF you specified during setup.
Card UDF 4 string	A UDF you specified during setup.
Card UDF 5 string	A UDF you specified during setup.
Created On date-time	The date and time when you created the card, in UTC. Standard – ISO 8601 code Example – `yyyy-mm-ddThh:mm:ss.sss`
Last Changed On date-time	The date and time when you last updated the card, in UTC. Standard – ISO 8601 code Example – `yyyy-mm-ddThh:mm:ss.sss`

Card ID

string

The card's unique identifier, prefixed with crd_.

Cardholder ID

string

The cardholder's unique identifier, prefixed with crh_

Card Product ID

string

The identifier for the card product, which represents the configuration that your card inherits. This is prefixed with pro_.

Entity ID

string

The entity's unique identifier, prefixed with ent_.

Client ID

string

Your unique identifier as a Checkout.com client, prefixed with cli_.

Type

string

The type of card. This can be one of:

multiple_use_virtual_card – A reusable non-physical card for card-not-present (CNP) transactions only
physical_card – A physical card
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

date-time

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

Masked PAN

string

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

Billing Currency

string

The currency in which you bill the cardholder.
Standard – ISO 4217 code
Example – USD

Issuing Country

string

The country where you issued the card.
Standard – ISO alpha-3 country code
Example – USA

Display Name

string

The display name you provided when creating the card.

Reference

string

The reference you provided when creating the card.

Card UDF 1

string

A user-defined field (UDF) you specified during setup.

Card UDF 2

string

A UDF you specified during setup.

Card UDF 3

string

A UDF you specified during setup.

Card UDF 4

string

A UDF you specified during setup.

Card UDF 5

string

A UDF you specified during setup.

Created On

date-time

The date and time when you created the card, in UTC.
Standard – ISO 8601 code
Example – yyyy-mm-ddThh:mm:ss.sss

Last Changed On

date-time

The date and time when you last updated the card, in UTC.
Standard – ISO 8601 code
Example – yyyy-mm-ddThh:mm:ss.sss

Cards Report

Report availability

Report format

Sample report

Information

Report fields