List wallet cards

GET 
/cards/wallet

List debit cards by wallet.

This endpoint:

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

Request

Query Parameters

walletId stringrequired

The ID of the wallet whose cards to retrieve

startAfterId string
limit number

Responses

200

The wallet cards were successfully retrieved.

application/json

Schema

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

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "referenceNumber": "1234567890123456",
      "lastDigits": "4321",
      "expiryDate": "1234567890123456",
      "status": "ACTIVE",
      "isVirtual": true,
      "isPrimary": false,
      "nickname": "Shopping Card",
      "type": "credit",
      "customerId": "550e8400-e29b-41d4-a716-446655440000",
      "walletId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "pagination": {
    "totalResults": 0,
    "hasMoreResults": true
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

Loading...