---
title: "List External Payment Cards"
method: GET
path: "/v2/payment-cards/external/"
tags: ["paymentCards"]
---

# List External Payment Cards

`GET /v2/payment-cards/external/`

List external debit cards. With a Partner API Token this returns every external card registered by consumers on your network; with a Customer Access Token it is scoped to that consumer's own cards. Use `GET /v2/consumers/{consumer_id}/payment-cards/external/` when you already know which consumer you want.

Requires any one of `api:read`, `api:card-management:read`, or `api:consumer-profile:read`.

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

- PaymentCardsListExternalPaymentCardsResponse200
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ExternalPaymentCard[], required
    - `external_id` string, uuid, required — Pass this as `external_payment_card_id` when creating an OCT or AFT.
    - `card_token` string, required — Network token representing the card.
    - `last_four` string — Last four digits of the card number. Empty when unavailable.
    - `expiry_month` string
    - `expiry_year` string
    - `status` 'active' | 'canceled' | 'closed' | 'deactivated' | 'expired' | 'frozen' | 'in_default' | 'in_progress', required — Card status. Only `active` cards can be used for OCT or AFT.
    - `deactivated_at` string, date-time, nullable — When the card was deactivated, if applicable.
    - `rail` string — Payment rail the card is reachable on.
    - `pushEnabled` boolean, required — Whether the card accepts OCT (push) transactions.
    - `pullEnabled` boolean, required — Whether the card accepts AFT (pull) transactions.
    - `card_company` string — Card network or issuing brand.

---

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