v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Cards on file

Get account cards on file

Get all cards on file for a specific account, which is derived from the access token.

Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.

get/cardsonfile/v2/cardsonfile/cards

Query parameters

statusstring

Card status - ACTIVE, SUSPENDED or PENDING. To filter more than one status, separate with a comma (,)

typestring

Card type - PLASTIC, VIRTUAL, TEMPORARY or RECURRING. To filter more than one type, separate with a comma (,)

Headers

Authorizationstring required

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an <b>Unauthorized</b> message.

Response

card_namestring

Card alias name. No limit.

card_profilestring

Network card profile identifier or HEX color. A profile or HEX color determines a card's appearance in a mobile payment app or payment system. Issuers are responsible for configuring card profiles with the card network.

card_status'ACTIVE' | 'SUSPENDED' | 'PENDING'

Card status

pismo_card_idinteger

Pismo card ID

customer_idinteger

Pismo customer ID.

program_idnumber

Pismo program ID.

creation_datestring

Creation date in RFC3339 format.

default_cardboolean

Is this card the default card? Default is false.

document_numberstring

Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.

expiration_datestring

Card expiration date (mmyy)

issuer_cardboolean

Is this the issuer's card? Default is false.

last_4_digitsstring

Last 4 PAN digits

network'AMEX' | 'MASTERCARD' | 'VISA' | 'UNKNOWN'

Card network that provisioned card

printed_namestring

Printed name on physical card

uuidstring

API-generated card UUID token

verifiedboolean

Is card verified? Default is false.

metadatastring

Any data object with key/value pairs. No limit on length.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

Example response

[
  {
    "card_name": "Vacation card",
    "card_profile": "0XFF00FF",
    "card_status": "ACTIVE",
    "pismo_card_id": 12376,
    "custom_id": 123456,
    "program_id": 1234567,
    "creation_date": "2018-11-05T19:21:42.000Z",
    "default_card": true,
    "document_number": "41440022209",
    "expiration_date": "1224",
    "issuer_card": true,
    "last_4_digits": "2347",
    "first_6_digits": "",
    "network": "VISA",
    "printed_name": "Jenna Flect",
    "uuid": "77cdd87e-b9b6-11ec-b4f5-4a7a44f81261",
    "verified": true,
    "metadata": "{any_key: any_value}"
  }
]