curl --request GET \
  --url 'https://api.nomba.com/v1/checkout/[email protected]' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Success",
  "data": {
    "hasNextPage": false,
    "nextPage": 0,
    "tokenizedCardDataList": [
      {
        "tokenKey": "1321595684",
        "cardType": "Verve",
        "tokenExpiryDate": "3108",
        "cardPan": "1913",
        "customerEmail": "[email protected]"
      }
    ]
  }
}

curl --request GET \
  --url 'https://api.nomba.com/v1/checkout/[email protected]' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Success",
  "data": {
    "hasNextPage": false,
    "nextPage": 0,
    "tokenizedCardDataList": [
      {
        "tokenKey": "1321595684",
        "cardType": "Verve",
        "tokenExpiryDate": "3108",
        "cardPan": "1913",
        "customerEmail": "[email protected]"
      }
    ]
  }
}

List tokenized cards

Look up the cards your customers have saved. Use this to show a customer their saved cards, or to find a card token if you missed the webhook. You can only see cards saved through your own Nomba account.

`GET /v1/checkout/tokenized-card-data`

Headers

string

required

Bearer <access_token>

string

required

Your account ID

Query parameters

string

The email address the card was saved with. When you send it, Nomba returns all of that customer’s cards in one response and ignores the other parameters.

string

Without customerEmail: return cards saved on or after this date and time, for example 2026-10-01T00:00:00

string

Without customerEmail: return cards saved on or before this date and time. Defaults to now.

integer

default:"50"

Without customerEmail: the number of cards per page

integer

Without customerEmail: the page to return. Omit it, or send 0, for the first page.

Response body

object

required

Hide object

boolean

required

true if there are more cards to fetch. Always false when you send customerEmail.

integer

required

The page to request next. 0 on the last page.

object[]

required

The saved cards

Show object

string

required

The card token

string

required

The email the card was saved with

string

required

The card scheme, for example Visa

string

required

The last four digits of the card

string

required

When the card expires, as YYMM. "2808" means August 2028.

To get the next page, send the value of data.nextPage as page, until hasNextPage is false.

curl --request GET \
  --url 'https://api.nomba.com/v1/checkout/[email protected]' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Success",
  "data": {
    "hasNextPage": false,
    "nextPage": 0,
    "tokenizedCardDataList": [
      {
        "tokenKey": "1321595684",
        "cardType": "Verve",
        "tokenExpiryDate": "3108",
        "cardPan": "1913",
        "customerEmail": "[email protected]"
      }
    ]
  }
}

Introduction

Getting Started

Products

API Basics

Guides

List saved cards

List tokenized cards

`GET /v1/checkout/tokenized-card-data`

Headers

Query parameters

Response body

List tokenized cards

​GET /v1/checkout/tokenized-card-data

​Headers

​Query parameters

​Response body

`GET /v1/checkout/tokenized-card-data`

Headers

Query parameters

Response body