v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
UPI

List cards

Return active account card list

post/v1/cards/list

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

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

user-agentstring required

Client consuming API.

Request body

external_transaction_datetimestring required

Request datetime. ISO 8601 format.

external_transaction_idstring required

Request ID code

type'' | 'PLASTIC' | 'VIRTUAL' | 'TEMPORARY'

Pismo card type. For more information, see Cards management. Default is empty string, meaning all card types are returned.

Example request

{
  "external_transaction_datetime": "2020-09-15T19:39:54.013Z",
  "external_transaction_id": "MGS584A1244F6BC4D50A3FABE6D93DF913C",
  "phone": {
    "country_code": "91",
    "phone": "9592714958"
  },
  "type": "PLASTIC"
}

Response

Response Body

external_transaction_datetimestring required

Request datetime. ISO 8601 format.

external_transaction_idstring required

Request ID code

Example response

{
  "cards": [
    {
      "account_reference_number": "12345600000000001140340134",
      "bin": "123456",
      "masked_number": "123456XXXXXXXX78",
      "printed_name": "Nan Tucket",
      "status": "ACTIVE",
      "type": "PLASTIC"
    }
  ],
  "external_transaction_datetime": "2020-09-15T19:39:54.013Z",
  "external_transaction_id": "MGS584A1244F6BC4D50A3FABE6D93DF913C",
  "phone": {
    "country_code": "91",
    "phone": "9592714958"
  }
}