Retrieve a stored card

Retrieve Token Information

get

Fetches basic information about a previously tokenized credit card using its unique identifier.

Authorizations

apiKeyAuthauthHeader

X-LoginstringRequired

Path parameters

card_identifierstringRequired

The unique card token obtained during tokenization

Header parameters

Content-TypestringRequired

Media type of the body sent to the API

Default: application/json

X-Datestring · date-timeRequired

ISO8601 Datetime with Timezone (yyyy-MM-dd'T'HH:mm:ssZ)

X-LoginstringRequired

Merchant X-Login API Key

AuthorizationstringRequired

Authorization control hash

X-Idempotency-KeystringOptional

Unique idempotency key for ensuring that the same request is not processed more than once

Responses

200

Successfully retrieved card information

application/json

holder_namestringRequired

Cardholder name

Example: Luis Perez

expiration_monthinteger · min: 1 · max: 12Required

Expiration month

Example: 10

expiration_yearintegerRequired

Expiration year

Example: 2028

last_four_digitsstringRequired

Last four digits of the card

Example: 1111Pattern: ^\d{4}$

brandstringRequired

The card brand

Example: VISA

first_sixstringRequired

The first six digits (BIN) of the card

Example: 411111Pattern: ^\d{6}$

400

Invalid request format

application/json

401

Unauthorized

application/json

404

Token not found

application/json

get

/v3/tokenization/{card_identifier}

HTTPcURLJavaScriptPython

GET /v3/tokenization/{card_identifier} HTTP/1.1
Host: cc-api-stg.onekeypayments.com
X-Login: text
Content-Type: application/json
X-Date: 2026-03-03T03:43:53.987Z
Authorization: text
Accept: */*

{
  "holder_name": "Luis Perez",
  "expiration_month": 10,
  "expiration_year": 2028,
  "last_four_digits": "1111",
  "brand": "VISA",
  "first_six": "411111"
}