GETMethod GET/products/{uid}/public

You read the public information of a product from its identifier. By the end of this page, you will know how to retrieve its name, the name and logo of its brand, an image, its token number, its registration transaction, its state, and whether it is reported stolen.

Full address:

GET https://api.sealtrust.io/v1/products/{uid}/public

The same endpoint also answers without the /v1 prefix, at https://api.sealtrust.io/products/{uid}/public. Both addresses call the same code. Use the /v1 form for a new integration.

#Authorization

None, public endpoint. This endpoint reads no API key, no token and no cookie. The server never looks at the Authorization header you send here, and it returns the same response to you with or without it.

#Call limit

No limit of its own for this endpoint. This path falls under the general counter of the API, counted per calling IP address over a 60 second window. That counter is shared with all the other API paths that have no limit of their own.

Plan for code 429 in your client and honor the Retry-After header it carries. The value of that counter can change without notice, so do not write any number into your code.

The response normally carries three headers that describe this counter. Build nothing that requires their presence: they can be missing.

That counter is independent of the daily quota of an API key. This call eats into neither that daily quota, nor the monthly product quota of your plan.

#Path and query parameters

You can send this identifier with or without the 0x prefix, in uppercase or in lowercase. The server strips the leading and trailing spaces before searching, puts the value in lowercase and adds the 0x prefix if it is missing. So these spellings all designate the same product.

This endpoint has no query parameter.

#Headers

No header is required.

#Request body

None. This request has no body.

#Example request

Reading the product whose identifier is 0x1111111111111111111111111111111111111111111111111111111111111111.

curl -i "https://api.sealtrust.io/v1/products/0x1111111111111111111111111111111111111111111111111111111111111111/public"

const uid =
  "0x1111111111111111111111111111111111111111111111111111111111111111";

const response = await fetch(
  `https://api.sealtrust.io/v1/products/${encodeURIComponent(uid)}/public`,
  { method: "GET" },
);

if (!response.ok) {
  throw new Error(`SealTrust a répondu ${response.status}`);
}

const produit = await response.json();

console.log(produit.product_name, produit.brand_name);
console.log(produit.is_verified, produit.declared_stolen);

import requests
from urllib.parse import quote

uid = "0x1111111111111111111111111111111111111111111111111111111111111111"

response = requests.get(
    f"https://api.sealtrust.io/v1/products/{quote(uid, safe='')}/public",
    timeout=30,
)

print(response.status_code)
print(response.json())

#Example response

HTTP code 200.

{
  "product_name": "Sac Modèle Exemple",
  "brand_name": "Exemple SAS",
  "brand_logo_url": "https://exemple-sas.test/logo.png",
  "image_url": "https://exemple-sas.test/media/sac-modele-exemple.jpg",
  "category_name": "Maroquinerie",
  "token_id": "11111111111111111111111111111111111111111111111111111111111111111111111111111",
  "tx_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
  "status": "written",
  "declared_stolen": false,
  "is_verified": true,
  "verified_at": "2026-03-04T10:22:31.481000+00:00",
  "contract_address": "0x3333333333333333333333333333333333333333",
  "chain": null
}

The response has thirteen fields and nothing else.

#Reading the state of a product

status carries a technical value. This page documents two of them, because the rest of the response depends on them: mined and written are the only two values for which is_verified is true.

Read is_verified and declared_stolen rather than interpreting status yourself. declared_stolen exists precisely for that: status carries the value stolen at the moment of a fresh report, then takes the value written back as soon as the theft case is closed, while declared_stolen says in a field of its own whether a report is open.

#Errors

The body of an error response carries a detail field.

This endpoint is public: it returns neither 401 nor 403.

#See also

• GET /resolve/{identifier}, read in a single call everything a product page displays.
• GET /timeline/{identifier}, read the public history of a product.
• GET /certificate/{identifier}, read the certificate of authenticity of an item.
• Core concepts, tell model, batch and item apart before ordering a single label.