Verify

Verify the digital signatures emitted by a NFC tag

POST /v1/tags/verify

Verifies the tag's authenticity via the unique uid, ctr, and cmac generated by each tap of the Legitimate Tag. This API will only return the success response the first time it is called with the correct tag information. Subsequent calls will return the HTTP status 422 and the error message has expired.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
uid	string (14 hex characters)	The unique ID of the tag
ctr	string (6 hex characters)	The nonce of the scan
cmac	string (20 hex characters)	The digital signature of the tag
tamper?	string (2 chars, CC for closed, OO for opened)	Tamper proof status of the tag (optional, only available with NFC tags with tamper detection capabilities)

Response

200

{
  uid: 'AABBCCDDEEFF00, // 16 hex characters
  verified: true,
  nft_chain_id: number, // optional
  nft_contract_address: string, // optional
  nft_token_id: number, // usually corresponds with serial_number
  name: string, // optional
  description: string, // optional
  image_url: string, // optional
  animation_url: string, // optional
  sku_id: number,
  serial_number: number, // auto assigned by order the tag is programmed in the SKU
}

4XX

{
  errors: {
    cmac: "has expired" | "is invalid",
    tag: ["could not be found"]
  }
}