Validate Latest

Validates CMAC and checks if tap is the latest registered tap of a tag

post

Validates a cmac for a tag using its UID, counter, and key. If valid, it checks whether the cmac corresponds to the most recent registered tap of that tag. Returns tag details and the latest verification entry if successful.

Body

application/json

uidstringRequired

Unique ID of the tag

Example: ABC123TAGUID

ctrstringRequired

Counter used in CMAC generation

Example: 00000045

cmacstringRequired

Truncated CMAC token from the tag

Example: 9f5e6a1c

Responses

200

cmac is valid and latest

application/json

404

Tag not found (invalid UID)

application/json

422

Invalid or outdated cmac

application/json

post

HTTPcURLJavaScriptPython

POST /external/v1/tags/cmac/latest HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "uid": "ABC123TAGUID",
  "ctr": "00000045",
  "cmac": "9f5e6a1c"
}

{
  "cmac_verified": true,
  "page_content": {
    "type": null,
    "version": null,
    "data": null,
    "options": {}
  },
  "tag": {
    "uid": "04603DCA9C1790",
    "tamper": null,
    "counter": 32,
    "created_at": "2025-05-07T17:25:46.075Z",
    "updated_at": "2025-05-23T21:13:17.844Z",
    "name": "Puma Mixtape Samples",
    "description": "The Evolution of Mixtape Vol. 2 is a special edition of the Puma RS-XL created in 2023 by Alexander-John and Emory Jones in partnership with Roc Nation.<br/><br/>Exclusive content including unreleased tracks, music videos, and more will be added every week after release.<br/><br/>Login to start listening. [Learn more](https://support.legitimate.tech/en/collections/4255487-puma-product-owner-s-manual).",
    "image_url": "https://imagedelivery.net/gzjejBRZvh-5ZMasSQlGQA/47769768-7234-444d-5919-2e7128fa0400/public",
    "animation_url": null,
    "notes": null,
    "redirect_url": null,
    "template_id": 193,
    "page_content": {
      "type": null,
      "data": null,
      "version": null,
      "options": {}
    },
    "shareable": false,
    "nft_chain_id": 43114,
    "nft_contract_address": "0x5774Fb705c21F0CD29AE1F950bB3AD66D3d82492",
    "nft_token_id": 206,
    "contract_version": 3,
    "verifications": 24,
    "external_verifications": 9,
    "qc": true,
    "tamper_enabled": false,
    "login_type": 1,
    "header_logo_url": null,
    "builder_io_api_key": "a6378b4031b246ebad5efa7540a24082",
    "builder_io_url": "/b/a6378b4031b246ebad5efa7540a24082/puma-mixtape",
    "tag_view_verifications_count": 23,
    "owner_address": null,
    "email_marketing_consent": null,
    "claim_count": 0,
    "reset_count": 0,
    "page_type": "builder_io",
    "total_tags_count": 206,
    "serial_number": 206,
    "owner_email": null
  },
  "verification": {
    "id": 5978,
    "tag_id": 48941,
    "cmac": "6C3BC119371FBFFB",
    "created_at": "2025-06-23T22:45:26.327Z",
    "updated_at": "2025-06-23T22:45:26.327Z"
  }
}