GET
/
customers
/
{customer_id}
/
instruments
/
{instrument_id}
Fetch Specific Saved Card Instrument
curl --request GET \
  --url https://sandbox.cashfree.com/pg/customers/{customer_id}/instruments/{instrument_id} \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
[
  {
    "customer_id": "akshita2106",
    "afa_reference": "2223295743",
    "instrument_id": "0d6b0245-f417-41a0-8151-0b03790de1f9",
    "instrument_type": "card",
    "instrument_uid": "a89b6054bd18f3f4a2e6663190c23aa7f39573dfde2ea2e5d3dbf1b31705f0da",
    "instrument_display": "XXXXXXXXXXXX5717",
    "instrument_status": "ACTIVE",
    "created_at": "2023-11-01T04:55:07.000+00:00",
    "instrument_meta": {
      "card_network": "visa",
      "card_bank_name": "AXIS BANK",
      "card_country": "IN",
      "card_type": "credit_card",
      "card_sub_type": "P",
      "card_token_details": {
        "par": "V0010013823048595023916090696",
        "expiry_month": "05",
        "expiry_year": "2028"
      }
    }
  },
  {
    "customer_id": "akshita2106",
    "afa_reference": "2372080606",
    "instrument_id": "36e3b8ab-27e5-4a33-baf6-31a2d412a530",
    "instrument_type": "card",
    "instrument_uid": "b6f4e24db8ab83e59dc57049b25f0fdfa9b730e329b9730d3d3fe0aba3ccfaa3",
    "instrument_display": "XXXXXXXXXXXX7293",
    "instrument_status": "ACTIVE",
    "created_at": "2024-01-04T09:16:37.000+00:00",
    "instrument_meta": {
      "card_network": "mastercard",
      "card_bank_name": "PUNJAB NATIONAL BANK",
      "card_country": "IN",
      "card_type": "debit_card",
      "card_sub_type": "R",
      "card_token_details": {
        "par": "5001D6TQMCHMY7SHM2SFANC3AWFSD",
        "expiry_month": "09",
        "expiry_year": "2028"
      }
    }
  },
  {
    "customer_id": "akshita2106",
    "afa_reference": "3128531647",
    "instrument_id": "0d6b0245-f417-41a0-8151-0b03790de1f9",
    "instrument_type": "card",
    "instrument_uid": "a89b6054bd18f3f4a2e6663190c23aa7f39573dfde2ea2e5d3dbf1b31705f0da",
    "instrument_display": "XXXXXXXXXXXX1001",
    "instrument_status": "ACTIVE",
    "created_at": "2024-10-10T10:16:18.000+00:00",
    "instrument_meta": {
      "card_network": "mastercard",
      "card_bank_name": "ICICI BANK",
      "card_country": "IN",
      "card_type": "credit_card",
      "card_sub_type": "P",
      "card_token_details": {
        "par": "5001AJE6CSF757UMKRTKK61PRVYGC",
        "expiry_month": "11",
        "expiry_year": "2027"
      }
    }
  }
]

Authorizations

​
x-client-id
string
header
required

Client app ID. You can find your app id in the Merchant Dashboard.

​
x-client-secret
string
header
required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

​
x-api-version
string
default:2025-01-01
required

API version to be used. Format is in YYYY-MM-DD.

​
x-request-id
string

Request ID for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to Cashfree.

​
x-idempotency-key
string<UUID>

An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.

Path Parameters

​
customer_id
string
required

The customer ID provided by the merchant during the Create Order API call, used to save cards for the customer.

​
instrument_id
string
required

The instrument_id of the saved instrument which needs to be queried.

Response

Saved card instrument object.

Use this API to fetch specific saved card stored for the customer in Cashfree’s Token Vault.

​
customer_id
string

Customer ID that merchant sends during Create Order API, against which the cards are saved for the customer.

​
afa_reference
string

cf_payment_id of the successful transaction done while saving instrument.

​
instrument_id
string

Identifier for the card saved at Cashfree.

​
instrument_type
string

Type of the saved instrument. Available option is card.

​
instrument_uid
string

Unique identifier for the saved card, used to identify a specific card.

​
instrument_display
string

Last four digits of actual card number.

​
instrument_status
string

Status of the saved instrument. Available options are ACTIVE, INACTIVE.

​
created_at
string

Timestamp at which instrument was saved.

​
instrument_meta
object

Card instrument meta information