POST
/
v1
/
tags
/
verify-authenticity
curl --request POST \
  --url https://third-party.etrnl.app/v1/tags/verify-authenticity \
  --header 'API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tagId": 123,
  "enc": "<string>",
  "cmac": "<string>",
  "tt": "<string>",
  "eCode": "<string>"
}'
{
	success: true,
	err: null,
	exists: true,
	authentic: true,
	ctr: 12,
	uid: "04C148EAC37180",
	ttCurrStatus: null,
	ttPermStatus: null,
	lastAuthenticTimestamp: "2023-07-09T09:23:53.672Z",
	lastAuthenticCtr: 11,
	metadata: {
		nftId: 'xxxxxxx'
	}
}
You can use either the Public or Private API Key

This endpoint can be used to test if the NFC generated dynamic data is authentic or inauthentic.

​
Error Messages

  • ctrBehind - The URL has expired and is no longer valid.
  • uidMismatch - The encrypted UID did not match the UID stored in our database for the tag ID. The encrypted data was probably tampered with.
  • cmacMismatch - CMAC signature check did not succeed. The CMAC was probably tampered with.
  • doesNotExist - The tag ID is invalid and does not exist in our database.
  • inactive - The tag has been marked as inactive in our database. This is probably a result of a tag that hasn’t been completely programmed.
  • unauthorized - The tag does not belong to your organization.

​
Headers

​
API-Key
string
required

Your organization’s public/private API key.

​
JSON Request Body

​
tagId
number
required

The ETRNL unique ID of the tag

​
enc
string
required

The encrypted message generated by the tag

​
cmac
string

The CMAC integrity data generated by the tag (Only required if tamper detection is not enabled)

​
tt
string

The encrypted tag tamper status generated by the tag. (Only required if tamper detection is enabled)

​
eCode
string
required

A KDF input parameter used for key decyrption

{
	success: true,
	err: null,
	exists: true,
	authentic: true,
	ctr: 12,
	uid: "04C148EAC37180",
	ttCurrStatus: null,
	ttPermStatus: null,
	lastAuthenticTimestamp: "2023-07-09T09:23:53.672Z",
	lastAuthenticCtr: 11,
	metadata: {
		nftId: 'xxxxxxx'
	}
}