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": "3128531647",
    "instrument_id": "41ad34ee-36a0-409e-aec9-bdc9d232add0",
    "instrument_type": "card",
    "instrument_uid": "78c2a3b90265436eceb4c09d8b09c85432ee1bb57512cc24ba998a12cd0180c2",
    "instrument_display": "XXXXXXXXXXXX1001",
    "instrument_status": "INACTIVE",
    "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

200
application/json

Saved card instrument object.