GETMethod GET/passport/01/{gtin}/10/{lot}

You read the digital passport published for a production batch. The batch is designated by the GTIN of its model and by its lot number, as in its GS1 Digital Link. When you leave this page, you will know how to fetch the content of the batch's passport, how to recognise that it is a batch, and why this address never falls back on the model.

Full address:

GET https://api.sealtrust.io/v1/passport/01/{gtin}/10/{lot}

The same endpoint also answers without the /v1 prefix. Use the /v1 form for a new integration.

#Authorization

None for the public tier, which is the default tier. The access tiers and the accounts that obtain them are exactly those of GET /passport/01/{gtin}: the same check applies to both addresses, through the same code.

#Rate limit

600 calls per window of 60 seconds, counted per calling IP address. This counter is shared by every read (GET) whose address starts with /passport.

#Path and query parameters

#Request body

None. This request has no body.

#Example request

Reading the passport of batch LOT-26A of GTIN 03701234567891, at the public tier.

curl -i "https://api.sealtrust.io/v1/passport/01/03701234567891/10/LOT-26A"

const gtin = "03701234567891";
const lot = "LOT-26A";

const response = await fetch(
  `https://api.sealtrust.io/v1/passport/01/${gtin}/10/${encodeURIComponent(lot)}`,
);

if (response.status === 404) {
  console.log("No passport published for this batch.");
} else {
  const passport = await response.json();
  console.log(passport.level, passport.batch_code, passport.passport_version);
}

from urllib.parse import quote

import requests

gtin = "03701234567891"
lot = "LOT-26A"

response = requests.get(
    f"https://api.sealtrust.io/v1/passport/01/{gtin}/10/{quote(lot, safe='')}",
    timeout=30,
)

if response.status_code == 404:
    print("No passport published for this batch.")
else:
    passport = response.json()
    print(passport["level"], passport["batch_code"], passport["passport_version"])

#Example response

HTTP code 200.

{
  "id": 412,
  "product_id": null,
  "product_model_id": 7,
  "gtin": "03701234567891",
  "level": "batch",
  "brand_id": 3,
  "brand_code": "K7Q2M9XH4B",
  "schema_version": "1.0",
  "passport_version": 2,
  "data": {
    "product_identity": {
      "gtin": "03701234567891",
      "batch_or_serial_identifier": "LOT-26A",
      "production_facility": "Atelier de Porto",
      "made_in": "PT"
    }
  },
  "data_hash": "9f2c1e7d4b8a6f0e3d5c2b1a9e8f7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e",
  "ipfs_uri": null,
  "visibility": "public",
  "published_at": "2026-09-26T08:00:00+00:00",
  "product_name": "T-shirt coton",
  "brand_name": "Atelier",
  "image_url": "https://atelier.test/images/cotton-t-shirt.jpg",
  "product_batch_id": 11,
  "batch_code": "LOT-26A"
}

Every value in this example is fictitious.

The other fields have the same meaning as in the response of GET /passport/01/{gtin}.

#Errors

#See also

• GET /passport/01/{gtin}/10/{lot}/proof, the public proofs of a batch's passport.
• GET /01/{gtin}/10/{lot}, the GS1 link of the batch.
• GET /passport/01/{gtin}, the passport of the model.