---
title: "Get a card's tokenizations"
method: GET
path: "/v1/tokenizations"
tags: ["Tokenization"]
---

# Get a card's tokenizations

`GET /v1/tokenizations`

List card tokenizations

## Query parameters

- `account_token` string, uuid
- `begin` string, date
- `card_token` string, uuid
- `end` string, date
- `tokenization_channel` 'DIGITAL_WALLET' | 'MERCHANT' | 'ALL'
- `ending_before` string
- `page_size` integer
- `starting_after` string

## Response `200`

OK

- object
  - `data` Tokenization[]
    - `account_token` string, uuid, required — The account token associated with the card being tokenized.
    - `card_token` string, uuid, required — The card token associated with the card being tokenized.
    - `created_at` string, date-time, required — Date and time when the tokenization first occurred. UTC time zone.
    - `device_id` string, nullable — The device identifier associated with the tokenization.
    - `digital_card_art_token` string, uuid, nullable — 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](https://docs.lithic.com/docs/about-digital-wallets#flexible-card-art).
    - `events` TokenizationEvent[] — A list of events related to the tokenization.
      - `created_at` string, date-time — Date and time when the tokenization event first occurred. UTC time zone.
      - `result` 'APPROVED' | 'DECLINED' | 'NOTIFICATION_DELIVERED' | 'REQUIRE_ADDITIONAL_AUTHENTICATION' | 'TOKEN_ACTIVATED' | 'TOKEN_CREATED' | 'TOKEN_DEACTIVATED' | 'TOKEN_DELETED_FROM_CONSUMER_APP' | 'TOKEN_INACTIVE' | 'TOKEN_STATE_UNKNOWN' | 'TOKEN_SUSPENDED' | 'TOKEN_UPDATED' — Enum representing the result of the tokenization event
      - `token` string, uuid — Globally unique identifier for a Tokenization Event
      - `type` 'TOKENIZATION_2FA' | 'TOKENIZATION_AUTHORIZATION' | 'TOKENIZATION_DECISIONING' | 'TOKENIZATION_ELIGIBILITY_CHECK' | 'TOKENIZATION_UPDATED' — Enum representing the type of tokenization event that occurred
      - `tokenization_decline_reasons` TokenizationDeclineReason[] — List of reasons why the tokenization was declined
      - `tokenization_tfa_reasons` TokenizationTfaReason[] — List of reasons why two-factor authentication was required
      - `rule_results` TokenizationRuleResult[] — Results from rules that were evaluated for this tokenization
        - `auth_rule_token` string, uuid, nullable, required — The Auth Rule Token associated with the rule. If this is set to null, then the result was not associated with a customer-configured rule. This may happen in cases where a tokenization is declined or requires TFA due to a Lithic-configured security or compliance rule, for example.
        - `result` 'APPROVED' | 'DECLINED' | 'REQUIRE_TFA' | 'ERROR', required — The result associated with this rule
        - `name` string, nullable, required — The name for the rule, if any was configured
        - `explanation` string, nullable, required — A human-readable explanation outlining the motivation for the rule's result
    - `status` 'ACTIVE' | 'DEACTIVATED' | 'INACTIVE' | 'PAUSED' | 'PENDING_2FA' | 'PENDING_ACTIVATION' | 'UNKNOWN', required — The status of the tokenization request
    - `token` string, uuid, required — Globally unique identifier for a Tokenization
    - `token_requestor_name` union, required — The entity that requested the tokenization. For digital wallets, this will be one of the defined wallet types. For merchant tokenizations, this will be a free-form merchant name string.
      - 'AMAZON_ONE' | 'ANDROID_PAY' | 'APPLE_PAY' | 'FACEBOOK' | 'FITBIT_PAY' | 'GARMIN_PAY' | 'GOOGLE_PAY' | 'MICROSOFT_PAY' | 'NETFLIX' | 'SAMSUNG_PAY' | 'UNKNOWN' | 'VISA_CHECKOUT' — Digital wallet type
      - string — Merchant name for merchant tokenizations
    - `token_unique_reference` string, required — The network's unique reference for the tokenization.
    - `dpan` string, nullable, required — The dynamic pan assigned to the token by the network.
    - `payment_account_reference_id` string, nullable — The network's unique reference for the card that is tokenized.
    - `tokenization_channel` 'DIGITAL_WALLET' | 'MERCHANT', required — The channel through which the tokenization was made.
    - `updated_at` string, date-time, required — Latest date and time when the tokenization was updated. UTC time zone.
  - `has_more` boolean

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | 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](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | 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 |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)