Detokenize Data

This API detokenizes ciphertext using an existing tokenization function. The tokenization function is identified by its unique ID, and the API returns the original plaintext.

---

Endpoint Details

URL	/v1/tokenize/detokenize
Method	POST
Authorization	Bearer Token

---

Request Headers

Header	Type	Description
Content-Type	String	Must be application/json

---

Request Body

Use the following format to make a request:

JSON Request

{
  "function_id": "dfae2591-01de-4beb-a8e2-f6c7ddf5f069",
  "ciphertext": "rg6aj@glr3udv.fai",
  "tweak_hex": "abcd1234"
}

---

Parameters

Parameter	Type	Description
function_id	UUID	Unique identifier of the tokenization function used to perform detokenization
ciphertext	String	Tokenized data to be detokenized
tweak_hex	String	Tweak value in hexadecimal format, required when the tokenization function uses the Generated or Supplied tweak type

---

Response

Here is an example response after the request has been successfully processed:

Response

{
    "plaintext": "admin@example.com"
}

---

Field Descriptions

Field	Type	Description
plaintext	String	Original plaintext obtained after successfully detokenizing the provided ciphertext

---

info

• A valid Bearer Token is required to access this endpoint.
• The function_id must refer to an existing tokenization function.
• The provided ciphertext must be generated using the same tokenization function (function_id) that is used for this detokenization request.
• tweak_hex is only required when the tokenization function uses the Generated or Supplied tweak type. It can be left empty for the Internal tweak type.
• The tweak_hex value must be at least 8 characters (hex).
• For more details on tweak types, refer to the User Guide.