Get a single card tokenization

Tokenization Token

Response Schema

200 OK

{
  "account_token": "uuid",
  "card_token": "uuid",
  "created_at": "date-time",
  "device_id": "string | null",
  "digital_card_art_token": "uuid | null",
  "events": [
    {
      "created_at": "date-time",
      "result": "string",
      "token": "uuid",
      "type": "string",
      "tokenization_decline_reasons": [
        "string"
      ],
      "tokenization_tfa_reasons": [
        "string"
      ],
      "rule_results": [
        {
          "auth_rule_token": "null | string",
          "result": "string",
          "name": "null | string",
          "explanation": "null | string",
          "status": "string",
          "token": "uuid"
        }
      ]
    }
  ],
  "status": "string",
  "token": "uuid",
  "token_requestor_name": "string",
  "token_unique_reference": "string",
  "dpan": "string | null",
  "payment_account_reference_id": "string | null",
  "tokenization_channel": "string",
  "updated_at": "date-time"
}

400 Bad Request

Code Description
Bad Request A parameter in the query given in the request does not match valid queries for the endpoint.

401 Unauthorized

Reason Description
User Not Authenticated Invalid or missing API key.
API Key Not Active The API key used is no longer active.
API Key Not Found The API key provided is not associated with any user.
Missing Authorization Header The Authorization header is not in the request.
Improper Authorization Format The Authorization header is not formatted properly.
Insufficient Privileges Write access requires an Issuing API key. Reach out at lithic.com/contact.
Insufficient Privileges for Cards Creating virtual cards requires an additional privilege.

429 Too Many Requests

Reason Description
Rate Limited - Too Many Requests User has exceeded their per second rate limit.
Rate Limited - Daily Limit Exceeded User has exceeded their daily rate limit.
Rate Limited - Too Many Keys Tried One IP has queried too many different API keys.

Example cURL Request

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

Example Response

{
  "account_token": "61c3acef-3c2c-4d61-9352-941397b92ca3",
  "card_token": "16a410c9-7f5c-43e9-8108-bb8a72c063f7",
  "created_at": "2023-08-28T15:57:14.578051",
  "events": [
    {
      "created_at": "2023-09-13T16:01:13.643241",
      "result": "TOKEN_ACTIVATED",
      "token": "a690b617-d3d4-4976-82f6-901f817ad98a",
      "type": "TOKENIZATION_UPDATED"
    },
    {
      "created_at": "2023-09-13T16:01:13.643241",
      "result": "APPROVED",
      "token": "2b2a1038-45f3-42e4-98bb-e745be3f1de1",
      "type": "TOKENIZATION_AUTHORIZATION",
      "tokenization_decline_reasons": [],
      "tokenization_tfa_reasons": [],
      "rule_results": []
    }
  ],
  "status": "ACTIVE",
  "token": "3e9a10da-11be-4a62-a510-d43548bfcec1",
  "token_requestor_name": "APPLE_PAY",
  "token_unique_reference": "DM4MMC0000332872ef1029f38fa0184b5c9260383da192b22",
  "tokenization_channel": "DIGITAL_WALLET",
  "dpan": "5489123487251234",
  "device_id": "ba6f05c312d4a5789b2e04f05c1f9d3b81GJ4AG1",
  "payment_account_reference_id": "50019T0AL7DEFGJ4AGGT8BQDOABCD",
  "updated_at": "2023-08-28T15:57:14.578051"
}