# Cards Report

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

---

## Report availability

The report data is refreshed twice daily at around 12:30 AM and 10:30 AM, in UTC.

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

- [In the Dashboard](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Generate_reports_in_the_Dashboard)
- [Using the API](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Retrieve_reports_via_API)
- [Using Secure File Transfer Protocol](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Access_reports_via_SFTP) (SFTP)
- [Using webhooks](https://www.checkout.com/docs/business-operations/retrieve-reports.md#Receive_reports_using_webhooks)

---

## Report format

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: <br>
`{Entity_name} > reports-{Entity_name} > issuing_cards`

---

## Sample report

[Download a sample report](https://www.checkout.com/docs/files/Sample_Card_Issuing_Cards_Report.csv) (CSV file).

> **Information**
>
> If using Safari, hold down the _Option_ key when selecting the link to download the file.

---

## Report fields

The report includes all the following fields in this order:

| Field name | Description |
| --- | --- |
| Card ID<br><br>`string` | The card's unique identifier, prefixed with `crd_`. |
| Cardholder ID<br><br>`string` | The cardholder's unique identifier, prefixed with `crh_` |
| Card Product ID<br><br>`string` | The identifier for the [card product](https://www.checkout.com/docs/card-issuing/set-up-card-program.md#Card_products), which represents the configuration that your card inherits. This is prefixed with `pro_`. |
| Entity ID<br><br>`string` | The entity's unique identifier, prefixed with `ent_`. |
| Client ID<br><br>`string` | Your unique identifier as a Checkout.com client, prefixed with `cli_`. |
| Type<br><br>`string` | The type of card. This can be one of:<br><br>- `multiple_use_virtual_card` – A reusable non-physical card for card-not-present (CNP) transactions only<br>- `physical_card` – A physical card<br>- `single_use_virtual_card` – A non-reusable non-physical card for CNP transactions only |
| Status<br><br>`string` | The current status of the card. This can be one of:<br><br>- `active` – The card is activated and not subject to any restrictions.<br>- `inactive` – The card is awaiting activation.<br>- `revoked` – You have canceled the card and all incoming authorizations will be declined.<br>- `suspended` – You have frozen the card and all transactions will be declined. |
| Expiry Date<br><br>`date-time` | The date when the card expires. <br>Format – `MM/YYYY` <br>Examples – `9/2025`, `11/2029` |
| Masked PAN<br><br>`string` | The card's masked primary account number (PAN). <br>Example – `1234 56** **** 7890` |
| Billing Currency<br><br>`string` | The currency in which you bill the cardholder. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br>Example – `USD` |
| Issuing Country<br><br>`string` | The country where you issued the card. <br>Standard – [ISO alpha-3 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes.md) <br>Example – `USA` |
| Display Name<br><br>`string` | The display name you provided when creating the card. |
| Reference<br><br>`string` | The reference you provided when creating the card. |
| Card UDF 1<br><br>`string` | A user-defined field (UDF) you specified during setup. |
| Card UDF 2<br><br>`string` | A UDF you specified during setup. |
| Card UDF 3<br><br>`string` | A UDF you specified during setup. |
| Card UDF 4<br><br>`string` | A UDF you specified during setup. |
| Card UDF 5<br><br>`string` | A UDF you specified during setup. |
| Created On<br><br>`date-time` | The date and time when you created the card, in UTC. <br>Standard – ISO 8601 code <br>Example – `yyyy-mm-ddThh:mm:ss.sss` |
| Last Changed On<br><br>`date-time` | The date and time when you last updated the card, in UTC. <br>Standard – ISO 8601 code <br>Example – `yyyy-mm-ddThh:mm:ss.sss` |