> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List external cards

> Retrieves a list of external cards associated with a specific account holder.

GET/v3/moneymovement/externalcards/accountholders/\{account\_holder\_token}

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](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_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](https://www.iso.org/iso-3166-country-codes.html). **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 JSON expandable lines wrap theme={null}
{
  "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"
    }
  ]
}
```

***


## Related topics

- [External Cards Overview](https://www.marqeta.com/docs/core-api/external-cards.md)
- [Instant Card Transfers](https://www.marqeta.com/docs/developer-guides/instant-card-transfers.md)
- [Add external card](https://www.marqeta.com/docs/core-api/external-cards/add.md)
- [Retrieve external card](https://www.marqeta.com/docs/core-api/external-cards/retrieve-external-card.md)
- [Update external card](https://www.marqeta.com/docs/core-api/external-cards/update-external-card.md)
