get https://test.cashfree.com/banking/customers//instruments?instrument_type
Use this API to get the details of multiple cards or instruments issued to your customer.
Click to view the response codes.
Response Codes
| Sub Code | Status | Message | Action |
|---|---|---|---|
| 200 | OK | - | - |
| 403 | ERROR | failed to authenticate | Ensure the client ID, secret key, and API version are mentioned in the API. |
| 404 | ERROR | customer with given id not found | Enter a valid input in the customer_id parameter. |
Click to view the response parameters and its descriptions.
Response Parameters
| Parameter | Description |
|---|---|
| instrument_id | It represents the unique ID entered to identify the prepaid payment instrument(PPI) card. |
| customer_id | It represents the unique ID entered to identify the customer. |
| instrument_type | It represents the type of the instrument. It is a hardcoded value - PREPAID_CARD. |
| remarks | It represents any remarks added. |
| mode | It represents the mode of the instrument - digital or physical card. |
| issuer | It represents the name card issuer. |
| network | It represents the network of the issued card or instrument. |
| prepaid_card_status | It represents the status of the issued card or instrument. The different statuses are - FAILED, PENDING, ACTIVE, INACTIVE, REJECTED, BLOCKED. |
| prepaid_card_sub_status | It represents the reason for the prepaid_card_status parameter. |
| last_4_digits | It represents the last 4 digits of the prepaid card instrument. |
| kit_number | It represents the kit number of the prepaid card. |
| verification_status | It represents the status of the KYC document verification. |
| verification_sub_status | It represents the reasons for the verification_status parameter. |
| expiry | It represents the expiry date of the prepaid card instrument. |
| added_on | It represents the date of the entry creation date. |
| cursor | It represents the value that can be used for pagination in the same API. |
| has_more | The value true represents that the customer has more instruments. The value false represents that the customer does not have any more instruments. |