Skip to main content

List customer cards

GET 
/cards/customer

Retrieves all cards associated with a customer. This endpoint:

  • Lists all cards for a specific customer
  • Includes card details and status
  • Provides pagination support
  • Returns card type information

Request​

Query Parameters

    customerId stringrequired

    The ID of the customer whose cards to retrieve

    startAfterId string
    limit number

Responses​

The customer cards were successfully retrieved.

Schema

    traceId string
    message string

    data

    object[]

  • Array [

    • id stringrequired

    Unique identifier of the card

    referenceNumber stringrequired

    The system card reference number

    lastDigits stringrequired

    Last 4 digits of cards number

    expiryDate stringrequired

    Expiration date

    status stringrequired

    Possible values: [ACTIVE, BLOCKED, SUSPENDED, CANCELLED]

    Current status of the card

    isVirtual booleanrequired

    Whether the card is virtual

    isPrimary booleanrequired

    Whether the card is the primary card

    nickname string

    Custom nickname for the card

    type stringrequired

    Possible values: [credit, debit]

    Type of the card

    customerId stringrequired

    ID of the customer who owns the card

    walletId string

    ID of the wallet the card is linked to (for debit cards)

  • ]

    • pagination

    object

    totalResults numberrequired
    hasMoreResults booleanrequired
Loading...