---
title: "Detokenize"
method: POST
path: "/v1/aliases/detokenize"
tags: ["/v1/aliases"]
---

# Detokenize

`POST /v1/aliases/detokenize`

Detokenize cards, CVVs and custom fields. It supports single and bulk detokenization for batches of requests.

## Request body

- BulkDetokenizeRequest
  - `requests` DetokenizeRequest[], required — List of detokenization requests.
    - union — List of detokenization requests.
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `alias` string — An alias received from a previous request.
        - `networkTokenOptions` DetokenizeNetworkTokenOptions
          - `returnNetworkToken` boolean — Request network token info.
          - `returnCryptogram` boolean — Request cryptogram info.
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `alias` string — A CVV alias received from a previous request. CVV aliases have a limited lifespan of 30 minutes and can't be detokenized anymore when expired.
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `alias` string — An alias received from a previous request.

## Response `200`

Successfully received detokenization request

- BulkDetokenizeResponse
  - `overview` ResponseOverview — Overview of results.
    - `total` integer — Total requests.
    - `successful` integer — Successful requests.
    - `failed` integer — Failed requests.
  - `responses` DetokenizeResponse[] — List of detokenization responses.
    - union — List of detokenization responses.
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `pan` string — The card number.
        - `expiryMonth` string — The expiry month of the card.
        - `expiryYear` string — The expiry year of the card.
        - `networkToken` NetworkToken — Network token details.
          - `token` string — Network token.
          - `status` 'INACTIVE' | 'ACTIVE' | 'SUSPENDED' | 'DELETED' | 'PENDING' | 'FAILED'
          - `cryptogram` string — Cryptogram.
          - `eci` string — Electronic Commerce Indicator (ECI). Not available for Mastercard and Amex. Returned for Visa only.
          - `expiryMonth` string — Expiry month.
          - `expiryYear` string — Expiry year.
          - `reason` NetworkTokenError
            - `code` 'SERVICE_NOT_ALLOWED' | 'TOKEN_PROVIDER_UNAVAILABLE' | 'MISSING_FIELD' | 'DECLINED' | 'REQUIRE_ADDITIONAL_AUTHENTICATION' | 'WAITING_ACTIVATION' | 'INTERNAL_ERROR' | 'UNKNOWN_ERROR'
            - `message` string
        - `validUntil` string, date-time — Valid until
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `cvv` string — The CVV number.
        - `validUntil` string, date-time — Valid until
      - object
        - `type` 'CARD' | 'CVV' | 'CUSTOM' | 'CERTIFICATE' | 'FINGERPRINT', required
        - `custom` string — The detokenized plain value.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/revisions/1f4f905fd175/schema)