GET/////
Retrieves a list of external cards associated with a specific account holder.
URL path parameters
| Fields | Description |
|---|---|
| account_holder_token string Required | Unique identifier of the account holder (user or business). Allowable Values: Valid account holder token |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of card resources to retrieve. The default value of this field is 10.Allowable Values: 1–50 |
| start_index integer Optional | Sort order index of the first resource in the returned array. The default value of this field is 0.Allowable Values: 0 min |
Response body
| Fields | Description |
|---|---|
| count integer Conditionally returned | Number of external card resources returned. Allowable Values: 1-10 |
| start_index integer Conditionally returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
| end_index integer Conditionally returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Conditionally returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
| data array of objects Conditionally returned | Array of external card objects. Allowable Values: Valid array of one or more card objects |
| data[].token string Conditionally returned | Unique identifier of the external card. Allowable Values: 36 char max |
| data[].expiration string Conditionally returned | Expiration date of the external card. Allowable Values: Format: MMyy |
| data[].last_four string Conditionally returned | Last four digits of the primary account number (PAN) of the external card. Allowable Values: 4 char |
| data[].issuing_bank string Conditionally returned | Issuing bank of the external card. Allowable Values: Bank name, as provided by the card network |
| data[].network string Conditionally returned | Name of the card network. Allowable Values: 255 char max |
| data[].status string Conditionally returned | Status of the external card. Allowable Values: ACTIVE, SUSPENDED, TERMINATED |
| data[].user_token string Conditionally returned | Unique identifier of the user. Allowable Values: 36 char max |
| data[].business_token string Conditionally returned | Unique identifier of the business. Allowable Values: 36 char max |
| data[].billing_details object Conditionally returned | Billing details. Allowable Values: Valid billing details object |
| data[].billing_details.first_name string Conditionally returned | First name or given name of the external account holder. Allowable Values: 40 char max |
| data[].billing_details.middle_name string Conditionally returned | Middle name of the external account holder. Allowable Values: 40 char max |
| data[].billing_details.last_name string Conditionally returned | Last or family name of the external account holder. Allowable Values: 40 char max |
| data[].billing_details.business_name string Conditionally returned | Business name of the external account holder. Allowable Values: 40 char max |
| data[].billing_details.address_1 string Returned | Street name and number of the external account holder’s address. Allowable Values: 255 char max |
| data[].billing_details.address_2 string Conditionally returned | Additional external account holder address information. Allowable Values: 255 char max |
| data[].billing_details.city string Returned | City of the external account holder’s address. Allowable Values: 40 char max |
| data[].billing_details.country_subdivision string Returned | Two-character state, province, or territorial abbreviation. For a complete list of valid abbreviations, see Valid state, provincial, and territorial abbreviations. Allowable Values: 2 chars |
| data[].billing_details.postal_code string Returned | Postal code of the external account holder’s address. Allowable Values: 20 char max |
| data[].billing_details.country string Returned | Country of the external account holder’s address in a valid alpha-3 ISO 3166 country code. Allowable Values: 3 chars |
| data[].is_eligible_for_pull boolean Conditionally returned | A value of true indicates that the external card is eligible for pulling funds.Allowable Values: true, false |
| data[].is_eligible_for_push boolean Conditionally returned | A value of true indicates that the external card is eligible for pushing funds.Allowable Values: true, false |
| data[].is_eligible_for_disbursement boolean Conditionally returned | A value of true indicates that the external card is eligible for disbursement.Allowable Values: true, false |
| data[].created_time datetime Conditionally returned | Date and time when the external card was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].last_modified_time datetime Conditionally returned | Date and time when the external card was updated, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"count": 2,
"start_index": 0,
"end_index": 1,
"is_more": false,
"data": [
{
"token": "ext_card_67890",
"expiration": "0630",
"last_four": "4444",
"status": "SUSPENDED",
"user_token": "user_67890",
"billing_details": {
"first_name": "Jane",
"last_name": "Doe",
"address_1": "123 Main Street",
"city": "Oakland",
"country_subdivision": "CA",
"postal_code": "94612",
"country": "USA"
},
"is_eligible_for_pull": true,
"is_eligible_for_push": false,
"is_eligible_for_disbursement": false,
"created_time": "2025-02-03T09:12:00Z",
"last_modified_time": "2025-03-10T14:45:20Z"
},
{
"token": "ext_card_12345",
"expiration": "1230",
"last_four": "1111",
"status": "ACTIVE",
"user_token": "user_67890",
"billing_details": {
"first_name": "Jane",
"last_name": "Doe",
"address_1": "123 Main Street",
"city": "Oakland",
"country_subdivision": "CA",
"postal_code": "94612",
"country": "USA"
},
"is_eligible_for_pull": true,
"is_eligible_for_push": true,
"is_eligible_for_disbursement": true,
"created_time": "2025-01-15T17:30:45Z",
"last_modified_time": "2025-01-15T17:30:45Z"
}
]
}