Links
🛠

API Access

API request and response interfaces are subject to change. Changes will be versioned. All customers will be notified of changes and provided upgrade instructions.
For clients that desire managed APIs and do not wish to connect to blockchain nodes, Legitimate offers APIs to its partners. It is billed by usage amount and comes with your own dedicated API gateways. It also supports custom domains and subdomains such as phygital-api.yourbrand.com/tags.

Standard Resources

Tags

POST /tags/{TAG_UUID}/verification
returns true/false along with tag metadata:
request_body: {
tag_uuid: string,
ctr: string,
cmac: string
}
response: boolean
POST /tags/{TAG_UUID}/claim
unlocks ownership of tag and transfers ownership to specified user
request_body: {
tag_uuid: string,
ctr: string,
cmac: string,
user_uuid: string,
}
GET /tags/{TAG_UUID}
returns data related to a tag
response_body: {
contract_address: string,
chain_id: number,
token_id: string
}

Custom Resources

We can work with your developer team to integrate our user management API resources with your infrastructure. Below are some examples of user resources that can be made available.
Because many of these combine blockchain data, third party identity providers, and data stored by Legitimate, higher usage rates will apply.

Tags

GET /tags/{TAG_UUID}
returns NFT metadata related to a tag
response_body: {
contract_address: string,
chain_id: number,
token_id: string,
nft_name: string,
nft_description: string,
nft_media_uri: string
}

Users

POST /users
creates a user (customer) and attaches user profile to specified metadata
request_body: {
email?: string,
phone?: string,
[key]: string
}
​
response_body: {
user_uuid: string
}
GET /users/{USER_ID}/tags
returns list of tag uuids owned by a specific customer
response_body: [
{tag_uuid}, {tag_uuid}, ...
]