LogoLogo
Our WorkHelp CenterAbout Us
  • Developer Resources
    • ⚙️Web/HTML Implementation
      • Getting Started
      • Simple HTML Example
  • Native App Implementation
  • 🛠️API Resources
    • Verify
    • Claim
    • Recover
    • Tag Verifications
  • Protocol
    • 🖼️Overview
      • Technical Specs
    • 📜Smart Contracts
      • 🔓Locking Mechanism
      • 🔓Locked721
      • 🔑Access Control Roles
      • 📃Customizing the Locked721 Contracts
    • 📏Customizations
      • 🛳️Blockchain Deployment Options
      • 🪙Digital ID Options
      • 🗞️Product Metadata Options
      • 🔐Locking Mechanism Options
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. API Resources

Claim

Register ownership of underlying digital ID

POST /v1/tags/claim

Transfers the digital ID (also known as digital token, or NFT) associated with the tag to the specified user address. The uid, cmac, and ctr must be from the latest successful verify attempt. All previous verifications are invalid to prevent users with old links from claiming.

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

walletAddress

string (40 hex chars with 0x header)

EVM based wallet address of each unique user

Response

{
  hash: string  // hash of on-chain transaction, tx may not be confirmed yet
}
{
  error: "This tag has not been enabled for claiming." |
    "This NFT has already been claimed and is no longer held by Legitimate." |
    "Session expired. Please tap the Legitimate Tag and try again."
}
PreviousVerifyNextRecover

Last updated 3 days ago

Was this helpful?

🛠️