--- title: "List Issued Cards" source_url: https://docs.rapyd.net/en/list-issued-cards.html lang: en --- # List Issued Cards Retrieve details of all issued cards. To filter the list for cards belonging to a specific wallet contact, use the `contact` query parameter. > **Note:** > > Clients with [PCI](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_pci_level_1 "PCI Level 1") certification can handle personal identifying information for cards. ### Parameters ### Request Query Parameters - - activation_end_date - Time of activation of the last card you want to retrieve, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - activation_start_date - Time of activation of the first card you want to retrieve, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - contact - ID of a wallet contact. String starting with **cont_**. - - creation_end_date - Time of creation of the last card you want to retrieve, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - creation_start_date - Time of creation of the first card you want to retrieve, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - page_number - Page number to retrieve. - - page_size - Number of results per page. - - status - Status of the card. One of the following: - **ACT** - Active. - **BLO** - Blocked. - **IMP** - Imported in bulk, but not yet personalized. - **INA** - Inactive. ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Response Parameters - - activated_at - Time that the card was activated, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - assigned_at - Time that the card was assigned to a cardholder, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - bin - [Bank Identifier Number](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_bin "Bank Identification Number") for the institution issuing the card. - - blocked_reason - Reason for blocking the card. One of the following: - **blocked_reversible** - **canceled** - **compliance** - **locked_incorrect_pin** - **migrated** - **none** - **other** - **reissued** - **suspected_fraud** none - - blocked_reason_code - Three letter code for the reason for blocking the card. One of the following values: - **CAN** - Canceled - **COM** - Compliance - **LOC** - Locked due to incorrect PIN - **LOS** - Lost - **MIG** - Migrated - **OTH** - Other - **REI** - Reissued - **SFR** - Suspected fraud - **STO** - Stolen - - card_id - ID of the card. String starting with **card_**. - - card_number - Actual card number. - - card_program - ID of the card program that the card is issued from. String starting with **cardprog_**. - - card_status_initiator - The initiator that asked for the card status update. One of the following three letter codes: - **CAH** - Cardholder - **COM** -Compliance operation - **DET** - Detect - **IGW** - Issuing gateway - **ISM** - Issuing merchant - **RSK** - Risk operation - **PRO** - Protect - - card_tracking_id - Reserved. - - country_iso_alpha_2 - The country where the card is issued. Two-letter ISO 3166-1 ALPHA-2 code. - - created_at - Time of creation of the issued card object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - cvv - Card security code. - - expiration_month - Expiration month of the card. Two digits. Relevant when the card issuer supports it for the country. - - expiration_year - Expiration year of the card. Two digits. Relevant when the card issuer supports it for the country. - - ewallet_contact - Describes the wallet contact that the card is assigned to. String starting with **cont_**. For details about the fields in the 'contact' object, see [Add Contact to Wallet](https://docs.rapyd.net/en/add-contact-to-wallet.md "Add Contact to Wallet"). - - id - ID of the issued card object. String starting with **ci_**. - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - public_details - Status of the card. One of the following: - `bin` - Bank ID number (BIN). - `last4` - Last 4 digits of the card. - `sub_bin` - Sub-BIN. - `expiration` - Expiration date as 4 digits. Relevant to [Issue Card](https://docs.rapyd.net/en/issue-card.md "Issue Card") and [List Issued Cards](https://docs.rapyd.net/en/list-issued-cards.md "List Issued Cards"). - - status - Status of the card. One of the following: - **ACT** - Active. - **BLO** - Blocked. - **IMP** - Imported in bulk, but not yet personalized. - **INA** - Inactive. - - sub_bin - Two-digit code. - /v1/issuing/cards - List Issued Cards - ```curl curl -X get 'https://sandboxapi.rapyd.net/v1/issuing/cards/' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "09f452be-a1d7-471d-b6ae-93ea20b150d2" }, "data": [ { "id": "ci_a033b230158b37c62d38bc86a0369ada", "ewallet_contact": { "id": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551237", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": "2000-12-15", "country": "NG", "nationality": null, "address": { "id": "address_8dc883799f2fcb5adb92bf77b6bc85b7", "name": "John Doe", "line_1": "123 Main Street", "line_2": "", "line_3": "", "city": "Anytown", "state": "", "country": "", "zip": "", "phone_number": "", "metadata": {}, "canton": "", "district": "", "created_at": 1755679320 }, "ewallet": "ewallet_3801e782955b29955445586a2405a5db", "created_at": 1612104554, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "" }, "status": "INA", "card_id": "card_1f804b2172c2827428dbec6cdd7db787", "assigned_at": 1760013474, "activated_at": 0, "metadata": {}, "country_iso_alpha_2": "BR", "created_at": 1760013475, "blocked_reason": "none", "blocked_reason_code": null, "card_status_initiator": null, "card_tracking_id": null, "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97", "public_details": { "bin": "518225", "last4": "7558", "sub_bin": "94", "expiration": "1028" }, "card_number": "5182250943847558", "cvv": "778", "expiration_month": "10", "expiration_year": "28", "bin": "518225", "sub_bin": "94" }, { "id": "ci_764863da11fa1777e1d1a840758db663", "ewallet_contact": { "id": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551237", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": "2000-12-15", "country": "NG", "nationality": null, "address": { "id": "address_8dc883799f2fcb5adb92bf77b6bc85b7", "name": "John Doe", "line_1": "123 Main Street", "line_2": "", "line_3": "", "city": "Anytown", "state": "", "country": "", "zip": "", "phone_number": "", "metadata": {}, "canton": "", "district": "", "created_at": 1755679320 }, "ewallet": "ewallet_3801e782955b29955445586a2405a5db", "created_at": 1612104554, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "" }, "status": "INA", "card_id": "card_0a37f11b57443844327929266d576faa", "assigned_at": 1760012981, "activated_at": 0, "metadata": {}, "country_iso_alpha_2": "BR", "created_at": 1760012981, "blocked_reason": "none", "blocked_reason_code": null, "card_status_initiator": null, "card_tracking_id": null, "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97", "public_details": { "bin": "520007", "last4": "4024", "sub_bin": "97", "expiration": "1028" }, "card_number": "5200072974364024", "cvv": "704", "expiration_month": "10", "expiration_year": "28", "bin": "520007", "sub_bin": "97" } ] } ``` - List Issued Cards by Contact - ```curl curl -X get 'https://sandboxapi.rapyd.net/v1/issuing/cards?cont_cb60ec28c2f0bdfc621cfc21270c20ce' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "66a1658a-551e-4651-9c77-c2c5d1bb2e03" }, "data": [ { "id": "ci_a033b230158b37c62d38bc86a0369ada", "ewallet_contact": { "id": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551237", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": "2000-12-15", "country": "NG", "nationality": null, "address": { "id": "address_8dc883799f2fcb5adb92bf77b6bc85b7", "name": "John Doe", "line_1": "123 Main Street", "line_2": "", "line_3": "", "city": "Anytown", "state": "", "country": "", "zip": "", "phone_number": "", "metadata": {}, "canton": "", "district": "", "created_at": 1755679320 }, "ewallet": "ewallet_3801e782955b29955445586a2405a5db", "created_at": 1612104554, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "" }, "status": "INA", "card_id": "card_1f804b2172c2827428dbec6cdd7db787", "assigned_at": 1760013474, "activated_at": 0, "metadata": {}, "country_iso_alpha_2": "BR", "created_at": 1760013475, "blocked_reason": "none", "blocked_reason_code": null, "card_status_initiator": null, "card_tracking_id": null, "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97", "public_details": { "bin": "518225", "last4": "7558", "sub_bin": "94", "expiration": "1028" }, "card_number": "5182250943847558", "cvv": "778", "expiration_month": "10", "expiration_year": "28", "bin": "518225", "sub_bin": "94" }, { "id": "ci_764863da11fa1777e1d1a840758db663", "ewallet_contact": { "id": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551237", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": "2000-12-15", "country": "NG", "nationality": null, "address": { "id": "address_8dc883799f2fcb5adb92bf77b6bc85b7", "name": "John Doe", "line_1": "123 Main Street", "line_2": "", "line_3": "", "city": "Anytown", "state": "", "country": "", "zip": "", "phone_number": "", "metadata": {}, "canton": "", "district": "", "created_at": 1755679320 }, "ewallet": "ewallet_3801e782955b29955445586a2405a5db", "created_at": 1612104554, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "" }, "status": "INA", "card_id": "card_0a37f11b57443844327929266d576faa", "assigned_at": 1760012981, "activated_at": 0, "metadata": {}, "country_iso_alpha_2": "BR", "created_at": 1760012981, "blocked_reason": "none", "blocked_reason_code": null, "card_status_initiator": null, "card_tracking_id": null, "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97", "public_details": { "bin": "520007", "last4": "4024", "sub_bin": "97", "expiration": "1028" }, "card_number": "5200072974364024", "cvv": "704", "expiration_month": "10", "expiration_year": "28", "bin": "520007", "sub_bin": "97" } ] } ```