- Itemoo
- Nhà phát triển
- Dữ liệu sản phẩm công khai
Tài liệu tham chiếu · v1
Itemoo Public Product Data API
Dữ liệu sản phẩm kèm nguồn gốc, schema.org JSON-LD, hộ chiếu dành cho người nhận và trình phân giải GS1 Digital Link. Không cần khóa.
Mô tả endpoint và trường bằng tiếng Anh — giống như mã và tên trường trong API.
Giới thiệu
https://itemoo.eu
Read-only product data published by producers on Itemoo — no key needed. The same QR code serves a person (HTML page) and a machine (JSON). Every fact points to the document that proves it; machine data is never richer or poorer than the page a person sees.
Languages. ?lang=xx or Accept-Language; texts fall back to the brand default language.
Errors. { statusCode, error, code, params?, message } — rely on code. A code of a product that is no longer maintained returns 410.
Limits. Calls are rate-limited per IP address (429 when exceeded); responses are cacheable — respect Cache-Control.
Product data
Product data with provenance
get/q/{code}/data
không cần khóa
Everything the human page shows, for machines: identity (GTIN, LOT, serial), product, facts with the document behind each, documents, FAQ, recall status and a trust section. Only the published version of the page is exposed. CORS is open (Access-Control-Allow-Origin: *); responses are cached for 5 minutes.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
langquery | string | Two-letter language; without it the Accept-Language header decides Ví dụ: en |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Phản hồi 200 · application/json
ProductData
identityProductIdentitybắt buộcCác trường · ProductIdentity
codestringbắt buộcItemoo code from the QR labellevel"unit" | "batch" | "variant" | "model"bắt buộcgtinstring | nullbắt buộcskustring | nullbắt buộcvariantobjectCác trường
labelstringbắt buộccatalogNostring | nullbắt buộc
lotstring | nullbắt buộcserialstring | nullbắt buộcexpiresAtstring (date-time) | nullbắt buộcstatusstringbắt buộcBatch status: ACTIVE | RECALLED | …uniqueProductIdentifierstringbắt buộcUnique product identifier of this code (EN 18219:2026): GS1 Digital Link with the batch and serial number of the code level, or the code address/q/{code}without a GTIN
productProductSummarybắt buộcCác trường · ProductSummary
namestringbắt buộcbrandstringbắt buộccategory"chemicals" | "cosmetics" | "medical" | "food" | "supplements" | "electronics" | "appliances" | "batteries" | "textiles" | "furniture" | "toys" | "construction" | "other" | nullbắt buộcRegulatory product type — decides the mandatory information: chemicals | cosmetics | medical | food | supplements | electronics | appliances | batteries | textiles | furniture | toys | construction | otherdescriptionstringbắt buộcimagestringtranslationsobjectName and description in every language the brand provides (ISO 639-1 code → text);nameanddescriptionabove are in the language of the responseCác trường
namemap<string, string>bắt buộcdescriptionmap<string, string>bắt buộc
manufacturerEconomicOperator | nullbắt buộcManufacturer with postal address and contact; null when the brand has not filled it inCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
responsiblePersonEconomicOperator | nullbắt buộcResponsible person in the EU; null when none is givenCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
importerEconomicOperator | nullbắt buộcImporter (Regulation (EU) 2024/1781 Annex III point (j)); for a batch or unit code the batch importerCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
authorisedRepresentativeEconomicOperator | nullbắt buộcAuthorised representative of the manufacturerCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
facilityEconomicOperator | nullbắt buộcManufacturing facility (Annex III point (i)); publicly only the town and country unless the brand made the full address publicCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
passportFieldsobjectbắt buộcModel passport fields with the public access level (empty until the page is published)languagestringbắt buộcLanguage of the texts (requested one when the brand has it)publishedbooleanbắt buộcfalse = the product page is not published yet; facts are emptymachineTranslatedbooleanbắt buộcpassportbooleanbắt buộcThe product has a Digital Product Passport: the brand added the “Digital product passport” block or the product is under a passport obligation. Public passport data fields (passportFields) are published for every productpassportStatus"NONE" | "ACTIVE" | "CLOSED"bắt buộcPassport state: NONE — no passport; ACTIVE; CLOSED — closed by the brand after the product was placed on the market (the passport shows the state as of the closing date)recallRecall | nullbắt buộcCác trường · Recall
activetruebắt buộccertainbooleanbắt buộctrue = this exact code is recalled; false = the batch is unknown and may be affectedscope"product" | "batch" | "lotRange"bắt buộcproduct = the whole product; batch = one batch; lotRange = a range of batch numbers (lotFrom–lotTo)reasonstringbắt buộcinstructionsstring | nullbắt buộclotFromstring | nullbắt buộclotTostring | nullbắt buộckind"recall" | "notice"recall = the product is recalled; notice = safety notice, the product is not withdrawn
factsProvenanceFact[]bắt buộcCác trường · ProvenanceFact
keystringStable English key of a standard fact (origin, materials, battery.capacityAh, chemical.ufi, …); absent for parameters defined by the brand — match on it, not on the translated namenamestringbắt buộcFact name in the response languagevaluestringbắt buộcprovenanceobjectCác trường
sourcestringbắt buộcDocument or block the fact comes fromversionstringdocumentUrlstringassertedBystringbắt buộcBrand that published the factassertedAtstring
offersobject[]bắt buộcCác trường
namestringbắt buộcpricenumberbắt buộccurrencystringbắt buộc
documentsDocument[]bắt buộcCác trường · Document
titlestringbắt buộcurlstringbắt buộckindstringbắt buộccertificate | declaration | repair | dpp | manual | sds | …versionstringaccessstringpublic | legit | authority — present on documents beyond the public leveldocIdstringLibrary document identifier — the same as in{ docId }values of document fieldslanguagestringLanguage of the file (ISO 639-1 code, e.g.de), set by the brand at the document version; absent — multilingual file or not specified
faqobject[]bắt buộcCác trường
questionstringbắt buộcanswerstringbắt buộc
trustobjectbắt buộcCác trường
assertedBystringbắt buộcpublishedVia"Itemoo"bắt buộcevidencePolicystringbắt buộcfactsWithProvenanceintegerbắt buộcfactsTotalintegerbắt buộclastUpdatedstring (date-time)bắt buộc
Lỗi
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/data'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/data', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/data');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
schema.org Product (JSON-LD)
get/q/{code}/schema.json
không cần khóa
The same product as schema.org Product in JSON-LD — for search engines and standard agents. Facts become additionalProperty with valueReference to the source document; the recall status is the first property (recallStatus).
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
langquery | string | Two-letter language; without it the Accept-Language header decides Ví dụ: en |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Phản hồi 200 · application/ld+json
object
@context"https://schema.org"bắt buộc@type"Product"bắt buộcnamestringbắt buộc
Lỗi
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/schema.json'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/schema.json', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/schema.json');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Parameter profile file
get/q/{code}/profile
không cần khóa
One parameter profile of the product (e.g. print settings for a resin) as a file: format=json gives { product, profile, params: [{ name, value }] }, ini (default) and cfg give key = value text for slicers.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
iquery | string | Profile index, 0 by default |
formatquery | "json" | "ini" | "cfg" | |
langquery | string |
Phản hồi 200 · application/json, text/plain
Profile file (attachment)
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/profile?format=json'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/profile?format=json', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/profile?format=json');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Capabilities for AI agents
get/.well-known/agent-interface.json
không cần khóa
Entry point for an agent that landed on the domain: the endpoints above and the evidence policy.
Phản hồi 200 · application/json
object
namestringbắt buộcdescriptionstringbắt buộcversionstringbắt buộcendpointsobject[]bắt buộcCác trường
pathstringbắt buộcmethodstringbắt buộcreturnsstringbắt buộcdescriptionstringbắt buộc
evidencePolicystringbắt buộc
Lỗi
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/.well-known/agent-interface.json'JavaScript
const res = await fetch('https://itemoo.eu/.well-known/agent-interface.json', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/.well-known/agent-interface.json');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Passport
Digital Product Passport (JSON-LD)
get/q/{code}/dpp.jsonld
không cần khóa
The passport in JSON-LD with the Itemoo context (https://itemoo.eu/ns/dpp/1.1/context.jsonld; version 1.0 stays published): fields map to the CIRPASS-2 ontology (https://w3id.org/eudpp#, battery modules) where the meaning matches, the rest to the Itemoo vocabulary. The product node is the unit, batch or model of the code; the passport node carries the version hash, backup copy, predecessor and successors, components and lifecycle status. The same document is returned by /q/{code} and the GS1 Digital Link addresses for Accept: application/ld+json (with Content-Location). With a recipient token or session it shows that level (then never cached). The CIRPASS-2 ontology is a project recommendation, not an EU data model; conformity with the EU semantic repository (Implementing Regulation (EU) 2026/1778) is not claimed. Only products with a passport have it — the brand added the “Digital product passport” block or the product is under a passport obligation (e.g. EV, LMT and industrial batteries above 2 kWh); other products answer 404 PASSPORT_NONE and publish their data in /q/{code}/data. A closed passport has lifecycle.status = closed and shows the state as of the closing date.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
langquery | string | Two-letter language; without it the Accept-Language header decides Ví dụ: en |
Authorizationheader | string | Bearer ipa_… — optional recipient token |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Phản hồi 200 · application/ld+json
object
@contextstringbắt buộcidstringbắt buộctype"Product"bắt buộcpassportobjectbắt buộcCác trường
type"DigitalProductPassport"bắt buộc
Lỗi
| 401 |
|
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/dpp.jsonld'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/dpp.jsonld', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/dpp.jsonld');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
JSON-LD context of Itemoo passports
get/ns/dpp/{version}/context.jsonld
không cần khóa
Immutable, versioned context (@protected). A change of content means a new version; documents name the version they use.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
versionpath · bắt buộc | string | Context version Ví dụ: 1.0 |
Phản hồi 200 · application/ld+json
object
@contextobjectbắt buộc
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/ns/dpp/1.0/context.jsonld'JavaScript
const res = await fetch('https://itemoo.eu/ns/dpp/1.0/context.jsonld', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/ns/dpp/1.0/context.jsonld');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Itemoo passport vocabulary
get/ns/dpp/{version}/vocab
không cần khóa
RDFS terms (itm:) used by the context for fields without a CIRPASS-2 equivalent, with labels in Polish and English; mapped fields are listed as equivalent properties.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
versionpath · bắt buộc | string | Vocabulary version Ví dụ: 1.0 |
Phản hồi 200 · application/ld+json
object
@idstringbắt buộc
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/ns/dpp/1.0/vocab'JavaScript
const res = await fetch('https://itemoo.eu/ns/dpp/1.0/vocab', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/ns/dpp/1.0/vocab');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Data model catalogue (DCAT-AP)
get/.well-known/dpp
không cần khóa
DCAT-AP description of the Itemoo passport data models (context, vocabulary, ontologies they build on) and of the resolver service. No index of products or brands.
Phản hồi 200 · application/ld+json
object
@idstringbắt buộc@type"dcat:Catalog"bắt buộc
Lỗi
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/.well-known/dpp'JavaScript
const res = await fetch('https://itemoo.eu/.well-known/dpp', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/.well-known/dpp');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Digital Product Passport
get/q/{code}/passport
không cần khóa
Public passport data; with a recipient token issued by the producer (legitimate interest or authority) also the fields, documents and unit history of that level. Send the token as Authorization: Bearer ipa_…. Never cached. A browser (Accept: text/html without a token) gets a readable passport page at the same address; format=json returns JSON anyway. Only products with a passport have it — the brand added the “Digital product passport” block or the product is under a passport obligation (e.g. EV, LMT and industrial batteries above 2 kWh); other products answer 404 PASSPORT_NONE and publish their data in /q/{code}/data. A closed passport has lifecycle.status = closed and shows the state as of the closing date.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
langquery | string | Two-letter language; without it the Accept-Language header decides Ví dụ: en |
atquery | string | The passport as it was at that moment, from the version history (a stable address of a version): ISO 8601 with a time zone (Z or ±hh:mm) or a plain date (start of the day, UTC). Without a time zone — 400 DATE_INVALID; in the future (over 60 s) — 400 DATE_IN_FUTUREVí dụ: 2027-03-01T10:00:00Z |
formatquery | "json" | "html" | json — JSON even for a browser; html — the passport page. Without it the Accept header decides. |
Authorizationheader | string | Bearer ipa_… — optional recipient token |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Phản hồi 200 · application/json
Passport
level"public" | "legit" | "authority"bắt buộcrecipientstringName of the access grant usedversionPassportVersion | nullbắt buộcCác trường · PassportVersion
hashstringbắt buộcSHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain headlayersobject[]bắt buộcCác trường
subject"product" | "variant" | "batch" | "unit"bắt buộcversionintegerbắt buộchashstringbắt buộc
eventsHeadstring | nullbắt buộcatstring (date-time)Present for a passport read at a point in time (?at=)
backupobject | nullbắt buộcBackup copy of the passport kept by a DPP service provider (Regulation (EU) 2024/1781 Annex III point (l)), when the brand designated oneCác trường
providerstringbắt buộcurlstringbắt buộc
identityProductIdentitybắt buộcCác trường · ProductIdentity
codestringbắt buộcItemoo code from the QR labellevel"unit" | "batch" | "variant" | "model"bắt buộcgtinstring | nullbắt buộcskustring | nullbắt buộcvariantobjectCác trường
labelstringbắt buộccatalogNostring | nullbắt buộc
lotstring | nullbắt buộcserialstring | nullbắt buộcexpiresAtstring (date-time) | nullbắt buộcstatusstringbắt buộcBatch status: ACTIVE | RECALLED | …uniqueProductIdentifierstringbắt buộcUnique product identifier of this code (EN 18219:2026): GS1 Digital Link with the batch and serial number of the code level, or the code address/q/{code}without a GTIN
productProductSummarybắt buộcCác trường · ProductSummary
namestringbắt buộcbrandstringbắt buộccategory"chemicals" | "cosmetics" | "medical" | "food" | "supplements" | "electronics" | "appliances" | "batteries" | "textiles" | "furniture" | "toys" | "construction" | "other" | nullbắt buộcRegulatory product type — decides the mandatory information: chemicals | cosmetics | medical | food | supplements | electronics | appliances | batteries | textiles | furniture | toys | construction | otherdescriptionstringbắt buộcimagestringtranslationsobjectName and description in every language the brand provides (ISO 639-1 code → text);nameanddescriptionabove are in the language of the responseCác trường
namemap<string, string>bắt buộcdescriptionmap<string, string>bắt buộc
manufacturerEconomicOperator | nullbắt buộcCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
responsiblePersonEconomicOperator | nullbắt buộcCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
importerEconomicOperator | nullbắt buộcCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
authorisedRepresentativeEconomicOperator | nullbắt buộcCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
facilityEconomicOperator | nullbắt buộcCác trường · EconomicOperator
namestringbắt buộcaddressobjectbắt buộcCác trường
streetstring | nullbắt buộcpostalCodestring | nullbắt buộccitystring | nullbắt buộccountrystring | nullbắt buộcISO 3166-1 alpha-2
emailstring | nullbắt buộcphonestring | nullbắt buộcShown only at the access level the brand chose for it (default: persons with a legitimate interest)source"company" | "registry"bắt buộccompany = the brand company data; registry = an operator from the company operator register designated in the passporttradeNamestring | nullRegistered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))identifiersobject[]Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)Các trường
scheme"gln" | "duns" | "lei" | "vat" | "iso15459"bắt buộcgln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agencyiacstringIssuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vatvaluestringbắt buộc
eoristring | nullEORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
languagestringbắt buộcpublishedbooleanbắt buộcrecallRecall | nullbắt buộcCác trường · Recall
activetruebắt buộccertainbooleanbắt buộctrue = this exact code is recalled; false = the batch is unknown and may be affectedscope"product" | "batch" | "lotRange"bắt buộcproduct = the whole product; batch = one batch; lotRange = a range of batch numbers (lotFrom–lotTo)reasonstringbắt buộcinstructionsstring | nullbắt buộclotFromstring | nullbắt buộclotTostring | nullbắt buộckind"recall" | "notice"recall = the product is recalled; notice = safety notice, the product is not withdrawn
factsProvenanceFact[]bắt buộcCác trường · ProvenanceFact
keystringStable English key of a standard fact (origin, materials, battery.capacityAh, chemical.ufi, …); absent for parameters defined by the brand — match on it, not on the translated namenamestringbắt buộcFact name in the response languagevaluestringbắt buộcprovenanceobjectCác trường
sourcestringbắt buộcDocument or block the fact comes fromversionstringdocumentUrlstringassertedBystringbắt buộcBrand that published the factassertedAtstring
documentsDocument[]bắt buộcCác trường · Document
titlestringbắt buộcurlstringbắt buộckindstringbắt buộccertificate | declaration | repair | dpp | manual | sds | …versionstringaccessstringpublic | legit | authority — present on documents beyond the public leveldocIdstringLibrary document identifier — the same as in{ docId }values of document fieldslanguagestringLanguage of the file (ISO 639-1 code, e.g.de), set by the brand at the document version; absent — multilingual file or not specified
componentsPassportComponent[]bắt buộcComponents with their own passport visible at this level (Regulation (EU) 2024/1781 Art. 2(4); CIRPASS-2 D4.1 recommendation 5)Các trường · PassportComponent
codestring | nullbắt buộcItemoo code of the component passport (unit, batch, variant or model — also of another brand)uristring | nullbắt buộcAddress of a component passport outside Itemoo (DPP URL or GS1 Digital Link)urlstringbắt buộcWhere to read the component passportrolestring | nullbắt buộcnameanybắt buộcquantitynumber | nullbắt buộcunitstring | nullbắt buộclevel"model" | "unit"bắt buộcmodel — bill of components of the model; unit — installed in this unit (assembly events)sincestring | nullbắt buộcWhen the component was installed in this unit
lifecycleobjectbắt buộcLifecycle status of the passport: recalled — an active recall covers the code (a safety notice does not); end_of_life — the unit was recycled or became waste; archived — the brand left Itemoo and the passport is kept read-only; closed — the brand closed the passport after the product was placed on the market (the passport shows the state as of the closing date,since). A passport is never deleted: removal is a status (CIRPASS-2 D4.1 recommendation 3); a retired code answers 410Các trường
status"active" | "recalled" | "end_of_life" | "archived" | "closed"bắt buộcsincestring (date-time) | nullbắt buộc
modelobjectbắt buộcModel passport fields visible at this levelunitobject | nullbắt buộcCác trường
serialstring | nullbắt buộcdataobjectbắt buộcstateobjectbắt buộcCác trường
statusstring | nullbắt buộcoriginal | repurposed | re-used | remanufactured | waste | recycled (Regulation (EU) 2023/1542 Annex XIII point 4(c); recycled ends the passport). null — not visible at this access level (a battery status is for persons with a legitimate interest only)sohnumber | nullbắt buộcState of health, 0–100 (SoH, or SOCE / remaining capacity when only that is recorded)sohAtstring (date-time) | nullbắt buộccyclesnumber | nullbắt buộcincidentsintegerbắt buộc
historyobject[]bắt buộcCác trường
kindstringbắt buộcdataanybắt buộcoccurredAtstring (date-time)bắt buộcsourcestring
linksobjectbắt buộcCác trường
predecessorobject | nullbắt buộcPassport before remanufacturing or repurposing (Art. 77(7))Các trường
codestringbắt buộcurlstringbắt buộc
successorsobject[]bắt buộcNew passports created from this batteryCác trường
codestringbắt buộcurlstringbắt buộc
custodianobject | nullbắt buộcOperator responsible for the passport of a waste battery after a transfer (producer, PRO or waste management operator — Art. 77(7))Các trường
namestringbắt buộcrolestringbắt buộcsincestring (date-time)bắt buộc
Lỗi
| 400 |
|
| 401 |
|
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Products this component is part of
get/q/{code}/passport/part-of
không cần khóa
Reverse component links: models whose bill of components lists this code and units where it is currently installed. A link is returned only when the reader has its access level AT THE BRAND OF THE PARENT product (a recipient token of that brand, or a market surveillance authority) — the component maker does not learn who uses its parts. Non-public reads are logged in the read log of the parent brand. Only products with a passport have it — the brand added the “Digital product passport” block or the product is under a passport obligation (e.g. EV, LMT and industrial batteries above 2 kWh); other products answer 404 PASSPORT_NONE and publish their data in /q/{code}/data. A closed passport has lifecycle.status = closed and shows the state as of the closing date.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
Authorizationheader | string | Bearer ipa_… — optional recipient token |
Phản hồi 200 · application/json
PartOf
codestringbắt buộcpartOfobject[]bắt buộcCác trường
codestringbắt buộcurlstringbắt buộcrolestring | nullbắt buộclevel"model" | "unit"bắt buộcsincestring | nullbắt buộc
Lỗi
| 401 |
|
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/part-of'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/part-of', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport/part-of');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Brand passport feed (JSON Feed)
get/b/{slug}/passport/feed.json
không cần khóa
Public feed of a brand for dealers, recyclers, marketplaces and authorities, without registering an address: recalls, safety notices and new versions of product and batch passports (names of the changed public fields; values are at the code address). No unit data. JSON Feed 1.1, ETag and 5-minute caching. The same entries as Atom: /b/{slug}/passport/feed.atom.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
slugpath · bắt buộc | string | Brand identifier from the brand app address Ví dụ: acme |
Phản hồi 200 · application/feed+json
object
version"https://jsonfeed.org/version/1.1"bắt buộcitemsobject[]bắt buộcCác trường
idstringbắt buộcurlstringbắt buộc
Lỗi
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/b/acme/passport/feed.json'JavaScript
const res = await fetch('https://itemoo.eu/b/acme/passport/feed.json', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/b/acme/passport/feed.json');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Brand passport feed (Atom)
get/b/{slug}/passport/feed.atom
không cần khóa
The brand passport feed as Atom 1.0 (see the JSON Feed variant).
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
slugpath · bắt buộc | string | Brand identifier Ví dụ: acme |
Phản hồi 200 · application/atom+xml
string
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/b/acme/passport/feed.atom'JavaScript
const res = await fetch('https://itemoo.eu/b/acme/passport/feed.atom', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/b/acme/passport/feed.atom');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Passport version history
get/q/{code}/passport/history
không cần khóa
Every change of passport fields (model, variant, batch, unit) is an append-only version chained by SHA-256 hashes. The response lists versions with the changes of fields visible at the reader's level (public without a token) and, for the authority level, the leaf hashes needed to recompute each version hash. Redacted values (personal data removed by the platform) keep their hash and show redacted: true. Only products with a passport have it — the brand added the “Digital product passport” block or the product is under a passport obligation (e.g. EV, LMT and industrial batteries above 2 kWh); other products answer 404 PASSPORT_NONE and publish their data in /q/{code}/data. A closed passport has lifecycle.status = closed and shows the state as of the closing date.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
Authorizationheader | string | Bearer ipa_… — optional recipient token |
Phản hồi 200 · application/json
PassportHistory
codestringbắt buộclevel"public" | "legit" | "authority"bắt buộcversionPassportVersion | nullbắt buộcCác trường · PassportVersion
hashstringbắt buộcSHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain headlayersobject[]bắt buộcCác trường
subject"product" | "variant" | "batch" | "unit"bắt buộcversionintegerbắt buộchashstringbắt buộc
eventsHeadstring | nullbắt buộcatstring (date-time)Present for a passport read at a point in time (?at=)
versionsobject[]bắt buộcCác trường
subject"product" | "variant" | "batch" | "unit"bắt buộcversionintegerbắt buộchashstringbắt buộcprevHashstring | nullbắt buộcatstring (date-time)bắt buộcsourcestringbắt buộcchangesobject[]bắt buộcCác trường
keystringbắt buộcop"add" | "change" | "remove"bắt buộcvalueanyredactedboolean
leavesmap<string, object>Leaf hashes (authority level only) to recompute the version hashCác trường
hstringbắt buộcaccess"public" | "legit" | "authority"bắt buộc
Lỗi
| 401 |
|
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/history'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/history', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport/history');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Proof of existence of the current passport versions
get/q/{code}/passport/anchor
không cần khóa
Every day (UTC) Itemoo builds a Merkle tree (RFC 6962 hashing: leaf = SHA-256(0x00 ‖ hash), node = SHA-256(0x01 ‖ left ‖ right), sorted unique leaves) of all passport version hashes and unit event hashes recorded that day and, when enabled, obtains an RFC 3161 timestamp for SHA-256(root). For each current layer version (and the head of the unit event chain) the response gives the day, the root and the inclusion path; anchor: null until the day is anchored. Verify the token with openssl ts -verify -digest <timestamp.digest> -in <token>. Only products with a passport have it — the brand added the “Digital product passport” block or the product is under a passport obligation (e.g. EV, LMT and industrial batteries above 2 kWh); other products answer 404 PASSPORT_NONE and publish their data in /q/{code}/data. A closed passport has lifecycle.status = closed and shows the state as of the closing date.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
Phản hồi 200 · application/json
PassportAnchorProofs
codestringbắt buộcalgorithmstring | nullbắt buộcproofsobject[]bắt buộcCác trường
subject"product" | "variant" | "batch" | "unit" | "events"bắt buộcversionintegerhashstringbắt buộcanchorobject | nullbắt buộcCác trường
daystringbắt buộcrootstringbắt buộcalgorithmstringbắt buộcleavesintegerbắt buộcpathobject[]bắt buộcCác trường
side"left" | "right"bắt buộchashstringbắt buộc
timestampobject | nullbắt buộcCác trường
providerstringbắt buộcatstringbắt buộcdigeststringbắt buộctokenstringbắt buộcBase64 RFC 3161 TimeStampResp
Lỗi
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/anchor'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/anchor', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport/anchor');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Request access to an archived passport
post/q/{code}/passport/access-request
không cần khóa
After the contract of the brand ends, regulated passports (batteries with the full passport) stay available in the Itemoo Passport Archive, but the brand no longer issues recipient tokens. Authorities and persons with a legitimate interest (Regulation (EU) 2023/1542 Annex XIII) request access here; a platform operator reviews the request and another one approves it (four eyes) and sends the token. Outside the archive the route answers 404 — ask the brand.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
Nội dung yêu cầu application/json
level"legit" | "authority"bắt buộcorganizationstringbắt buộcAuthority, service, recycler…emailstringbắt buộcContact e-mail for the token (deleted 180 days after the decision)justificationstringbắt buộcWhy the access is needed and on what basis
Phản hồi 200 · application/json
PassportAccessRequestCreated
idstringbắt buộcstatus"new"bắt buộc
Lỗi
| 400 |
|
| 404 |
|
| 409 |
|
| 429 |
|
Ví dụ
cURL
curl -X POST 'https://itemoo.eu/q/A1B2C3D4/passport/access-request' \
-H 'Content-Type: application/json' \
-d '{"level":"legit","organization":"Recycling Sp. z o.o.","email":"office@example.com","justification":"Dismantling and recycling of the battery received as waste."}'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/access-request', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"level": "legit",
"organization": "Recycling Sp. z o.o.",
"email": "office@example.com",
"justification": "Dismantling and recycling of the battery received as waste."
}),
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport/access-request');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"level":"legit","organization":"Recycling Sp. z o.o.","email":"office@example.com","justification":"Dismantling and recycling of the battery received as waste."}',
]);
$data = json_decode(curl_exec($ch), true);Restricted passport document file
get/q/{code}/passport/documents/{versionId}
không cần khóa
The file of a document outside the public level (e.g. dismantling information, test reports — Annex XIII points 2–3 of Regulation (EU) 2023/1542). Its address comes from documents[].url of GET /q/{code}/passport read with a token; the public file address of such a document returns 404. Requires Authorization: Bearer ipa_… with a level that sees the document; every download is recorded in the producer's access log. Never cached.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
codepath · bắt buộc | string | Itemoo code from the QR label (unit, batch, variant or product) Ví dụ: A1B2C3D4 |
versionIdpath · bắt buộc | string | Document version id from the passport Ví dụ: clx0doc0version0001 |
Authorizationheader | string | Bearer ipa_… — recipient token (required) |
Phản hồi 200 · application/pdf, application/octet-stream
Document file
Lỗi
| 401 |
|
| 404 |
|
| 410 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/documents/clx0doc0version0001'JavaScript
const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/documents/clx0doc0version0001', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/q/A1B2C3D4/passport/documents/clx0doc0version0001');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
GS1 Digital Link
Resolve a GTIN
get/01/{gtin}
không cần khóa
GS1 Digital Link resolver. With linkType=linkset or Accept: application/linkset+json it returns the linkset (RFC 9264) built from the published page: product page, instructions, certificates, passport and recall status. With linkType=gs1:<type> it redirects (307) to the first link of that type. Without either it shows the product page (HTML). One GTIN used by several brands returns a choice of their pages.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
gtinpath · bắt buộc | string | GTIN (8–14 digits) Ví dụ: 05901234123457 |
linkTypequery | string | "linkset" = the whole linkset (also with Accept: application/linkset+json); "gs1:pip" etc. = 307 redirect to the first link of that type |
langquery | string | |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Acceptheader | string | application/linkset+json returns the linkset without linkType. |
Phản hồi 200 · application/linkset+json
Linkset
linksetmap<string, string | object[]>[]bắt buộcOne entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)Các trường
hrefstringbắt buộctitlestringtypestringhreflangstring[]
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/01/05901234123457?linkType=linkset'JavaScript
const res = await fetch('https://itemoo.eu/01/05901234123457?linkType=linkset', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/01/05901234123457?linkType=linkset');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Resolve a GTIN with a batch
get/01/{gtin}/10/{lot}
không cần khóa
GS1 Digital Link resolver. With linkType=linkset or Accept: application/linkset+json it returns the linkset (RFC 9264) built from the published page: product page, instructions, certificates, passport and recall status. With linkType=gs1:<type> it redirects (307) to the first link of that type. Without either it shows the product page (HTML). One GTIN used by several brands returns a choice of their pages.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
gtinpath · bắt buộc | string | GTIN (8–14 digits) Ví dụ: 05901234123457 |
lotpath · bắt buộc | string | |
linkTypequery | string | "linkset" = the whole linkset (also with Accept: application/linkset+json); "gs1:pip" etc. = 307 redirect to the first link of that type |
langquery | string | |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Acceptheader | string | application/linkset+json returns the linkset without linkType. |
Phản hồi 200 · application/linkset+json
Linkset
linksetmap<string, string | object[]>[]bắt buộcOne entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)Các trường
hrefstringbắt buộctitlestringtypestringhreflangstring[]
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/01/05901234123457/10/L2026-10?linkType=linkset'JavaScript
const res = await fetch('https://itemoo.eu/01/05901234123457/10/L2026-10?linkType=linkset', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/01/05901234123457/10/L2026-10?linkType=linkset');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Resolve a GTIN with a serial number
get/01/{gtin}/21/{serial}
không cần khóa
GS1 Digital Link resolver. With linkType=linkset or Accept: application/linkset+json it returns the linkset (RFC 9264) built from the published page: product page, instructions, certificates, passport and recall status. With linkType=gs1:<type> it redirects (307) to the first link of that type. Without either it shows the product page (HTML). One GTIN used by several brands returns a choice of their pages.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
gtinpath · bắt buộc | string | GTIN (8–14 digits) Ví dụ: 05901234123457 |
serialpath · bắt buộc | string | |
linkTypequery | string | "linkset" = the whole linkset (also with Accept: application/linkset+json); "gs1:pip" etc. = 307 redirect to the first link of that type |
langquery | string | |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Acceptheader | string | application/linkset+json returns the linkset without linkType. |
Phản hồi 200 · application/linkset+json
Linkset
linksetmap<string, string | object[]>[]bắt buộcOne entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)Các trường
hrefstringbắt buộctitlestringtypestringhreflangstring[]
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/01/05901234123457/21/SN-0001?linkType=linkset'JavaScript
const res = await fetch('https://itemoo.eu/01/05901234123457/21/SN-0001?linkType=linkset', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/01/05901234123457/21/SN-0001?linkType=linkset');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Resolve a GTIN with a batch and a serial number
get/01/{gtin}/10/{lot}/21/{serial}
không cần khóa
GS1 Digital Link resolver. With linkType=linkset or Accept: application/linkset+json it returns the linkset (RFC 9264) built from the published page: product page, instructions, certificates, passport and recall status. With linkType=gs1:<type> it redirects (307) to the first link of that type. Without either it shows the product page (HTML). One GTIN used by several brands returns a choice of their pages.
Tham số
| Trường | Kiểu | Mô tả |
|---|---|---|
gtinpath · bắt buộc | string | GTIN (8–14 digits) Ví dụ: 05901234123457 |
lotpath · bắt buộc | string | |
serialpath · bắt buộc | string | |
linkTypequery | string | "linkset" = the whole linkset (also with Accept: application/linkset+json); "gs1:pip" etc. = 307 redirect to the first link of that type |
langquery | string | |
Accept-Languageheader | string | Preferred language of the texts (fact names, description) when lang is missing. |
Acceptheader | string | application/linkset+json returns the linkset without linkType. |
Phản hồi 200 · application/linkset+json
Linkset
linksetmap<string, string | object[]>[]bắt buộcOne entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)Các trường
hrefstringbắt buộctitlestringtypestringhreflangstring[]
Lỗi
| 404 |
|
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/01/05901234123457/10/L2026-10/21/SN-0001?linkType=linkset'JavaScript
const res = await fetch('https://itemoo.eu/01/05901234123457/10/L2026-10/21/SN-0001?linkType=linkset', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/01/05901234123457/10/L2026-10/21/SN-0001?linkType=linkset');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.
Resolver description
get/.well-known/gs1resolver
không cần khóa
GS1 resolver description: supported keys and link types, for scanners and passport registries.
Phản hồi 200 · application/json
object
Lỗi
| 429 |
|
Ví dụ
cURL
curl -X GET 'https://itemoo.eu/.well-known/gs1resolver'JavaScript
const res = await fetch('https://itemoo.eu/.well-known/gs1resolver', {
method: 'GET',
});
const data = await res.json();PHP
$ch = curl_init('https://itemoo.eu/.well-known/gs1resolver');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);Dùng thử
Không thể gửi yêu cầu.