Get a single card tokenization

get https://sandbox.lithic.com/v1/tokenizations/{tokenization_token}

Get tokenization

Responses

Response body

object

data

object

account_token

string

required

The account token associated with the card being tokenized.

card_token

string

required

The card token associated with the card being tokenized.

created_at

date-time

required

Date and time when the tokenization first occurred. UTC time zone.

digital_card_art_token

string

Specifies the digital card art displayed in the user’s digital wallet after tokenization. This will be null if the tokenization was created without an associated digital card art. See Flexible Card Art Guide.

events

array of objects

A list of events related to the tokenization.

events

object

created_at

date-time

Date and time when the tokenization event first occurred. UTC time zone.

result

string

Enum representing the result of the tokenization event

APPROVED DECLINED NOTIFICATION_DELIVERED REQUIRE_ADDITIONAL_AUTHENTICATION TOKEN_ACTIVATED TOKEN_CREATED TOKEN_DEACTIVATED TOKEN_INACTIVE TOKEN_STATE_UNKNOWN TOKEN_SUSPENDED TOKEN_UPDATED

token

string

Globally unique identifier for a Tokenization Event

type

string

Enum representing the type of tokenization event that occurred

TOKENIZATION_2FA TOKENIZATION_AUTHORIZATION TOKENIZATION_DECISIONING TOKENIZATION_ELIGIBILITY_CHECK TOKENIZATION_UPDATED

status

string

required

The status of the tokenization request

ACTIVE DEACTIVATED INACTIVE PAUSED PENDING_2FA PENDING_ACTIVATION UNKNOWN

token

string

required

Globally unique identifier for a Tokenization

token_requestor_name

string

required

The entity that requested the tokenization. Represents a Digital Wallet or merchant.

AMAZON_ONE ANDROID_PAY APPLE_PAY FACEBOOK FITBIT_PAY GARMIN_PAY MICROSOFT_PAY NETFLIX SAMSUNG_PAY UNKNOWN VISA_CHECKOUT

token_unique_reference

string

required

The network's unique reference for the tokenization.

dpan

string | null

required

The dynamic pan assigned to the token by the network.

payment_account_reference_id

string | null

The network's unique reference for the card that is tokenized.

tokenization_channel

string

required

The channel through which the tokenization was made.

DIGITAL_WALLET MERCHANT

updated_at

date-time

required

Latest date and time when the tokenization was updated. UTC time zone.


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://sandbox.lithic.com/v1/tokenizations/tokenization_token \
3
     --header 'accept: application/json'


xxxxxxxxxx
26
}
1
{
2
  "account_token": "61c3acef-3c2c-4d61-9352-941397b92ca3",
3
  "card_token": "16a410c9-7f5c-43e9-8108-bb8a72c063f7",
4
  "created_at": "2023-08-28T15:57:14.578051",
5
  "events": [
6
    {
7
      "created_at": "2023-09-13T16:01:13.643241",
8
      "result": "TOKEN_ACTIVATED",
9
      "token": "a690b617-d3d4-4976-82f6-901f817ad98a",
10
      "type": "TOKENIZATION_UPDATED"
11
    },
12
    {
13
      "created_at": "2023-09-13T16:01:13.643241",
14
      "result": "APPROVED",
15
      "token": "2b2a1038-45f3-42e4-98bb-e745be3f1de1",
16
      "type": "TOKENIZATION_AUTHORIZATION"
17
    }
18
  ],
19
  "status": "ACTIVE",
20
  "token": "3e9a10da-11be-4a62-a510-d43548bfcec1",
21
  "token_requestor_name": "APPLE_PAY",
22
  "token_unique_reference": "DM4MMC0000332872ef1029f38fa0184b5c9260383da192b22",
23
  "dpan": 5489123487251234,
24
  "payment_account_reference_id": "50019T0AL7DEFGJ4AGGT8BQDOABCD",
25
  "updated_at": "2023-08-28T15:57:14.578051"

200OK

400A parameter in the query given in the request does not match the valid queries for the endpoint.