Core

Generate a fingerprint for an encrypted value and retrieve metadata such as the time of encryption, the type of data, the data role and category-specific metadata (e.g., card metadata) without accessing the plaintext value.

post/fingerprint

Request

Request body

tokenstring required

The encrypted data to be fingerprinted.

Example request

{
  "token": "ev:debug:Tk9D:HBpzdbFWXbX/N2cC:AyjMY/SKO49SlkXcDPtCGs+DxnUn/F8/lAtajCYZ/xT7:KV7AUn9vJJkZDtL8PKdOc8Y11yTL2vZQasFuHqM=:$"
}

Response

The metadata of the encrypted data that was submitted for fingerprinting.

type'integer' | 'float' | 'boolean' | 'string' required

The type of the encrypted value.

category'card-number'

The category or specific nature of the encrypted value.

encryptedAtinteger

The date and time when the value was encrypted. This is a Unix timestamp in milliseconds. This field is currently only populated for values encrypted with a Data Role.

rolestring

The data role of the encrypted value.

fingerprintstring required

A unique identifier for the encrypted value.

Example response

{
  "type": "string",
  "category": "card-number",
  "encryptedAt": 1700067122000,
  "role": "payment-data",
  "fingerprint": "WUlcOAgQcTN1GEUaoaKrLH1wL2PZrjsUS7byUGZyUEA",
  "metadata": {
    "bin": "424242",
    "lastFour": "4242",
    "brand": "visa",
    "funding": "debit",
    "country": "gb",
    "currency": "gbp",
    "issuer": "Gringotts Wizarding Bank and Trust Company",
    "segment": "consumer"
  }
}

Changes