---
title: "List External Cards"
method: GET
path: "/external_cards"
tags: ["External Cards"]
---

# List External Cards

`GET /external_cards`

Get a paginated list of External Cards

## Query parameters

- `business_id` string[]
- `payment_account_reference` string[]
- `name` string[]
- `name_like` string
- `from_creation_time` string, date-time
- `status_neq` 'ACTIVE' | 'DELETED' | 'SUSPENDED' — Status of an External Card
- `status` ExternalCardStatus[]
- `from_last_updated_time` string, date-time
- `from_deletion_time` string, date-time
- `last_four` string[]
- `to_last_updated_time` string, date-time
- `tenant` TenantId[]
- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get
- `limit` integer — Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.
- `to_deletion_time` string, date-time
- `to_creation_time` string, date-time
- `customer_id` string[]
- `id` string[]

## Response `200`

External Card list

- ExternalCardListResponse
  - `external_cards` ExternalCardResponse[], required — Array of External Cards
    - `bin` string — Bank Identification Number
    - `created_time` string, date-time
    - `currency` string, required — ISO 4217 Alpha-3 currency code
    - `customer_id` string, uuid, required — The unique identifier of a customer
    - `deletion_time` string, date-time
    - `expiration_month` string, required
    - `expiration_year` string, required
    - `id` string, required — External card ID
    - `issuer` string — Name of issuing financial institution
    - `last_four` string, required — The last 4 digits of the card PAN
    - `last_modified_time` string, date-time
    - `name` string, required — The cardholder name
    - `status` 'ACTIVE' | 'DELETED' | 'SUSPENDED', required — Status of an External Card
    - `verifications` ExternalCardVerifications — Verify card passed AVS and CVV checks and if it able to perform PUSH/PULL transfers.
      - `address_verification_result` 'ADDRESS_AND_ZIP_MISMATCH' | 'ADDRESS_MISMATCH' | 'NOT_VERIFIED' | 'VERIFIED' | 'ZIP_MISMATCH', required — Address verification results Status | Description --- | --- VERIFIED | AVS verified NOT_VERIFIED | AVS not verified ADDRESS_MISMATCH | ZIP code match, address no match ZIP_MISMATCH | Address match, ZIP code no match ADDRESS_AND_ZIP_MISMATCH | Address and ZIP code no match
      - `cvv2_result` 'CVV_MISMATCH' | 'NOT_SUPPORTED' | 'NOT_VERIFIED' | 'VERIFIED', required — Card Verification Value results Status | Description --- | --- VERIFIED | CVV and expiration date verified NOT_VERIFIED | CVV and expiration date not verified CVV_MISMATCH | Either CVV or expiration date does not match NOT_SUPPORTED | Issuer does not participate in CVV2 service
      - `name_verification_result` 'NAME_MISMATCH' | 'NOT_SUPPORTED' | 'NOT_VERIFIED' | 'VERIFIED', required — Issuer cardholder name verification result with Account Name Inquiry (ANI) service The result of verifying the cardholder name against the name on file at the issuing institution. If this fails, it means the issuing institution has a different person's name on file as the cardholder. Status | Description --- | --- VERIFIED | ANI Name verified NOT_VERIFIED | ANI Name not verified NOT_SUPPORTED | Issuer does not participate in ANI service NAME_MISMATCH | ANI Name does not match
      - `pull_details` PullDetails — Additional PULL transfer details
        - `country` string — ISO-3166-1 Alpha-2 country code
        - `currency` string — ISO 4217 Alpha-3 currency code
        - `network` string — Payment network
        - `product_type` 'CREDIT' | 'DEBIT' | 'PREPAID' — Product type
        - `regulated` boolean — Exemption status from debit card interchange fee standards
      - `pull_enabled` boolean, required — Indicates if the card is able to perform PULL transfers.
      - `push_details` PushDetails — Additional PUSH transfer details
        - `country` string — ISO-3166-1 Alpha-2 country code
        - `currency` string — ISO 4217 Alpha-3 currency code
        - `funds_availability` 'FEW' | 'NEXT' | 'NOW' — Estimated timeframe of funds availability Value | Description --- | --- NOW | Within 30 minutes NEXT | Within the next business day FEW | Within a few business days
        - `network` string — Payment network
        - `product_type` 'CREDIT' | 'DEBIT' | 'PREPAID' — Product type
        - `regulated` boolean — Exemption status from debit card interchange fee standards
      - `push_enabled` boolean, required — Indicates if the card is able to perform PUSH transfers.
      - `state` 'FAILED' | 'SUCCEEDED', required
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/revisions/b0d812e6cdd0/schema)