Skip to main content
POST
/
identities
/
{identity_id}
/
detokenize
Detokenize identity
curl --request POST \
  --url http://localhost:5001/identities/{identity_id}/detokenize \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/identities/{identity_id}/detokenize"

headers = {"X-blnk-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)
const options = {method: 'POST', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/identities/{identity_id}/detokenize', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_PORT => "5001",
CURLOPT_URL => "http://localhost:5001/identities/{identity_id}/detokenize",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-blnk-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "http://localhost:5001/identities/{identity_id}/detokenize"

req, _ := http.NewRequest("POST", url, nil)

req.Header.Add("X-blnk-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("http://localhost:5001/identities/{identity_id}/detokenize")
.header("X-blnk-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/identities/{identity_id}/detokenize")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["X-blnk-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
Use blnk.identity.detokenize to detokenize several identity fields.
1

Call the method

blnk.identity.detokenize
response = blnk.identity.detokenize(
  "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
  {
    "fields": ["FirstName", "EmailAddress"],
  },
)
FieldTypeDescription
idstrIdentity ID.
fieldsstring[]PascalCase field names to detokenize. Pass [] for all tokenized fields.
2

Use the plaintext values

Read response.data["fields"] for the original values. Handle these values securely and avoid logging them.
3

Response

200 OK
{
  "fields": {
    "firstName": "Alice",
    "emailAddress": "alice.smith@example.com"
  }
}
FieldTypeDescription
fieldsdict[str, str]Original values for the fields you requested.

PII tokenization

Setup, access controls, and how detokenization works.

Detokenize multiple fields

HTTP request and response schema.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.