Itemoo Public Product Data API

Параметри

Відповідь 200 · application/json

ProductData

• identityProductIdentityобов’язкове
  ›Поля · ProductIdentity

  • codestringобов’язкове
    Itemoo code from the QR label
  • level"unit" | "batch" | "variant" | "model"обов’язкове
  • gtinstring | nullобов’язкове
  • skustring | nullобов’язкове
  • variantobject
    ›Поля

    • labelstringобов’язкове
    • catalogNostring | nullобов’язкове
  • lotstring | nullобов’язкове
  • serialstring | nullобов’язкове
  • expiresAtstring (date-time) | nullобов’язкове
  • statusstringобов’язкове
    Batch status: ACTIVE | RECALLED | …
  • uniqueProductIdentifierstringобов’язкове
    Unique 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
• productProductSummaryобов’язкове
  ›Поля · ProductSummary

  • namestringобов’язкове
  • brandstringобов’язкове
  • category"chemicals" | "cosmetics" | "medical" | "food" | "supplements" | "electronics" | "appliances" | "batteries" | "textiles" | "furniture" | "toys" | "construction" | "other" | nullобов’язкове
    Regulatory product type — decides the mandatory information: chemicals | cosmetics | medical | food | supplements | electronics | appliances | batteries | textiles | furniture | toys | construction | other
  • descriptionstringобов’язкове
  • imagestring
  • translationsobject
    Name and description in every language the brand provides (ISO 639-1 code → text); name and description above are in the language of the response
    ›Поля

    • namemap<string, string>обов’язкове
    • descriptionmap<string, string>обов’язкове
• manufacturerEconomicOperator | nullобов’язкове
  Manufacturer with postal address and contact; null when the brand has not filled it in
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• responsiblePersonEconomicOperator | nullобов’язкове
  Responsible person in the EU; null when none is given
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• importerEconomicOperator | nullобов’язкове
  Importer (Regulation (EU) 2024/1781 Annex III point (j)); for a batch or unit code the batch importer
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• authorisedRepresentativeEconomicOperator | nullобов’язкове
  Authorised representative of the manufacturer
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• facilityEconomicOperator | nullобов’язкове
  Manufacturing facility (Annex III point (i)); publicly only the town and country unless the brand made the full address public
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• passportFieldsobjectобов’язкове
  Model passport fields with the public access level (empty until the page is published)
• languagestringобов’язкове
  Language of the texts (requested one when the brand has it)
• publishedbooleanобов’язкове
  false = the product page is not published yet; facts are empty
• machineTranslatedbooleanобов’язкове
• passportbooleanобов’язкове
  The 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 product
• passportStatus"NONE" | "ACTIVE" | "CLOSED"обов’язкове
  Passport 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 | nullобов’язкове
  ›Поля · Recall

  • activetrueобов’язкове
  • certainbooleanобов’язкове
    true = this exact code is recalled; false = the batch is unknown and may be affected
  • scope"product" | "batch" | "lotRange"обов’язкове
    product = the whole product; batch = one batch; lotRange = a range of batch numbers (lotFrom–lotTo)
  • reasonstringобов’язкове
  • instructionsstring | nullобов’язкове
  • lotFromstring | nullобов’язкове
  • lotTostring | nullобов’язкове
  • kind"recall" | "notice"
    recall = the product is recalled; notice = safety notice, the product is not withdrawn
• factsProvenanceFact[]обов’язкове
  ›Поля · ProvenanceFact

  • keystring
    Stable 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 name
  • namestringобов’язкове
    Fact name in the response language
  • valuestringобов’язкове
  • provenanceobject
    ›Поля

    • sourcestringобов’язкове
      Document or block the fact comes from
    • versionstring
    • documentUrlstring
    • assertedBystringобов’язкове
      Brand that published the fact
    • assertedAtstring
• offersobject[]обов’язкове
  ›Поля

  • namestringобов’язкове
  • pricenumberобов’язкове
  • currencystringобов’язкове
• documentsDocument[]обов’язкове
  ›Поля · Document

  • titlestringобов’язкове
  • urlstringобов’язкове
  • kindstringобов’язкове
    certificate | declaration | repair | dpp | manual | sds | …
  • versionstring
  • accessstring
    public | legit | authority — present on documents beyond the public level
  • docIdstring
    Library document identifier — the same as in { docId } values of document fields
  • languagestring
    Language 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[]обов’язкове
  ›Поля

  • questionstringобов’язкове
  • answerstringобов’язкове
• trustobjectобов’язкове
  ›Поля

  • assertedBystringобов’язкове
  • publishedVia"Itemoo"обов’язкове
  • evidencePolicystringобов’язкове
  • factsWithProvenanceintegerобов’язкове
  • factsTotalintegerобов’язкове
  • lastUpdatedstring (date-time)обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/data'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/data', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/ld+json

object

• @context"https://schema.org"обов’язкове
• @type"Product"обов’язкове
• namestringобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/schema.json'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/schema.json', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/json, text/plain

Profile file (attachment)

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/profile?format=json'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/profile?format=json', {
  method: 'GET',
});
const data = await res.json();

$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);

Відповідь 200 · application/json

object

• namestringобов’язкове
• descriptionstringобов’язкове
• versionstringобов’язкове
• endpointsobject[]обов’язкове
  ›Поля

  • pathstringобов’язкове
  • methodstringобов’язкове
  • returnsstringобов’язкове
  • descriptionstringобов’язкове
• evidencePolicystringобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/.well-known/agent-interface.json'

const res = await fetch('https://itemoo.eu/.well-known/agent-interface.json', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/ld+json

object

• @contextstringобов’язкове
• idstringобов’язкове
• type"Product"обов’язкове
• passportobjectобов’язкове
  ›Поля

  • type"DigitalProductPassport"обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/dpp.jsonld'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/dpp.jsonld', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/ld+json

object

• @contextobjectобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/ns/dpp/1.0/context.jsonld'

const res = await fetch('https://itemoo.eu/ns/dpp/1.0/context.jsonld', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/ld+json

object

• @idstringобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/ns/dpp/1.0/vocab'

const res = await fetch('https://itemoo.eu/ns/dpp/1.0/vocab', {
  method: 'GET',
});
const data = await res.json();

$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);

Відповідь 200 · application/ld+json

object

• @idstringобов’язкове
• @type"dcat:Catalog"обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/.well-known/dpp'

const res = await fetch('https://itemoo.eu/.well-known/dpp', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/json

Passport

• level"public" | "legit" | "authority"обов’язкове
• recipientstring
  Name of the access grant used
• versionPassportVersion | nullобов’язкове
  ›Поля · PassportVersion

  • hashstringобов’язкове
    SHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain head
  • layersobject[]обов’язкове
    ›Поля

    • subject"product" | "variant" | "batch" | "unit"обов’язкове
    • versionintegerобов’язкове
    • hashstringобов’язкове
  • eventsHeadstring | nullобов’язкове
  • atstring (date-time)
    Present for a passport read at a point in time (?at=)
• backupobject | nullобов’язкове
  Backup copy of the passport kept by a DPP service provider (Regulation (EU) 2024/1781 Annex III point (l)), when the brand designated one
  ›Поля

  • providerstringобов’язкове
  • urlstringобов’язкове
• identityProductIdentityобов’язкове
  ›Поля · ProductIdentity

  • codestringобов’язкове
    Itemoo code from the QR label
  • level"unit" | "batch" | "variant" | "model"обов’язкове
  • gtinstring | nullобов’язкове
  • skustring | nullобов’язкове
  • variantobject
    ›Поля

    • labelstringобов’язкове
    • catalogNostring | nullобов’язкове
  • lotstring | nullобов’язкове
  • serialstring | nullобов’язкове
  • expiresAtstring (date-time) | nullобов’язкове
  • statusstringобов’язкове
    Batch status: ACTIVE | RECALLED | …
  • uniqueProductIdentifierstringобов’язкове
    Unique 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
• productProductSummaryобов’язкове
  ›Поля · ProductSummary

  • namestringобов’язкове
  • brandstringобов’язкове
  • category"chemicals" | "cosmetics" | "medical" | "food" | "supplements" | "electronics" | "appliances" | "batteries" | "textiles" | "furniture" | "toys" | "construction" | "other" | nullобов’язкове
    Regulatory product type — decides the mandatory information: chemicals | cosmetics | medical | food | supplements | electronics | appliances | batteries | textiles | furniture | toys | construction | other
  • descriptionstringобов’язкове
  • imagestring
  • translationsobject
    Name and description in every language the brand provides (ISO 639-1 code → text); name and description above are in the language of the response
    ›Поля

    • namemap<string, string>обов’язкове
    • descriptionmap<string, string>обов’язкове
• manufacturerEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• responsiblePersonEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• importerEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• authorisedRepresentativeEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• facilityEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered 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)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = 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 agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• languagestringобов’язкове
• publishedbooleanобов’язкове
• recallRecall | nullобов’язкове
  ›Поля · Recall

  • activetrueобов’язкове
  • certainbooleanобов’язкове
    true = this exact code is recalled; false = the batch is unknown and may be affected
  • scope"product" | "batch" | "lotRange"обов’язкове
    product = the whole product; batch = one batch; lotRange = a range of batch numbers (lotFrom–lotTo)
  • reasonstringобов’язкове
  • instructionsstring | nullобов’язкове
  • lotFromstring | nullобов’язкове
  • lotTostring | nullобов’язкове
  • kind"recall" | "notice"
    recall = the product is recalled; notice = safety notice, the product is not withdrawn
• factsProvenanceFact[]обов’язкове
  ›Поля · ProvenanceFact

  • keystring
    Stable 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 name
  • namestringобов’язкове
    Fact name in the response language
  • valuestringобов’язкове
  • provenanceobject
    ›Поля

    • sourcestringобов’язкове
      Document or block the fact comes from
    • versionstring
    • documentUrlstring
    • assertedBystringобов’язкове
      Brand that published the fact
    • assertedAtstring
• documentsDocument[]обов’язкове
  ›Поля · Document

  • titlestringобов’язкове
  • urlstringобов’язкове
  • kindstringобов’язкове
    certificate | declaration | repair | dpp | manual | sds | …
  • versionstring
  • accessstring
    public | legit | authority — present on documents beyond the public level
  • docIdstring
    Library document identifier — the same as in { docId } values of document fields
  • languagestring
    Language 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[]обов’язкове
  Components with their own passport visible at this level (Regulation (EU) 2024/1781 Art. 2(4); CIRPASS-2 D4.1 recommendation 5)
  ›Поля · PassportComponent

  • codestring | nullобов’язкове
    Itemoo code of the component passport (unit, batch, variant or model — also of another brand)
  • uristring | nullобов’язкове
    Address of a component passport outside Itemoo (DPP URL or GS1 Digital Link)
  • urlstringобов’язкове
    Where to read the component passport
  • rolestring | nullобов’язкове
  • nameanyобов’язкове
  • quantitynumber | nullобов’язкове
  • unitstring | nullобов’язкове
  • level"model" | "unit"обов’язкове
    model — bill of components of the model; unit — installed in this unit (assembly events)
  • sincestring | nullобов’язкове
    When the component was installed in this unit
• lifecycleobjectобов’язкове
  Lifecycle 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 410
  ›Поля

  • status"active" | "recalled" | "end_of_life" | "archived" | "closed"обов’язкове
  • sincestring (date-time) | nullобов’язкове
• modelobjectобов’язкове
  Model passport fields visible at this level
• unitobject | nullобов’язкове
  ›Поля

  • serialstring | nullобов’язкове
  • dataobjectобов’язкове
  • stateobjectобов’язкове
    ›Поля

    • statusstring | nullобов’язкове
      original | 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 | nullобов’язкове
      State of health, 0–100 (SoH, or SOCE / remaining capacity when only that is recorded)
    • sohAtstring (date-time) | nullобов’язкове
    • cyclesnumber | nullобов’язкове
    • incidentsintegerобов’язкове
  • historyobject[]обов’язкове
    ›Поля

    • kindstringобов’язкове
    • dataanyобов’язкове
    • occurredAtstring (date-time)обов’язкове
    • sourcestring
  • linksobjectобов’язкове
    ›Поля

    • predecessorobject | nullобов’язкове
      Passport before remanufacturing or repurposing (Art. 77(7))
      ›Поля

      • codestringобов’язкове
      • urlstringобов’язкове
    • successorsobject[]обов’язкове
      New passports created from this battery
      ›Поля

      • codestringобов’язкове
      • urlstringобов’язкове
  • custodianobject | nullобов’язкове
    Operator responsible for the passport of a waste battery after a transfer (producer, PRO or waste management operator — Art. 77(7))
    ›Поля

    • namestringобов’язкове
    • rolestringобов’язкове
    • sincestring (date-time)обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/json

PartOf

• codestringобов’язкове
• partOfobject[]обов’язкове
  ›Поля

  • codestringобов’язкове
  • urlstringобов’язкове
  • rolestring | nullобов’язкове
  • level"model" | "unit"обов’язкове
  • sincestring | nullобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/part-of'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/part-of', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/feed+json

object

• version"https://jsonfeed.org/version/1.1"обов’язкове
• itemsobject[]обов’язкове
  ›Поля

  • idstringобов’язкове
  • urlstringобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/b/acme/passport/feed.json'

const res = await fetch('https://itemoo.eu/b/acme/passport/feed.json', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/atom+xml

string

Приклад

curl -X GET 'https://itemoo.eu/b/acme/passport/feed.atom'

const res = await fetch('https://itemoo.eu/b/acme/passport/feed.atom', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/json

PassportHistory

• codestringобов’язкове
• level"public" | "legit" | "authority"обов’язкове
• versionPassportVersion | nullобов’язкове
  ›Поля · PassportVersion

  • hashstringобов’язкове
    SHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain head
  • layersobject[]обов’язкове
    ›Поля

    • subject"product" | "variant" | "batch" | "unit"обов’язкове
    • versionintegerобов’язкове
    • hashstringобов’язкове
  • eventsHeadstring | nullобов’язкове
  • atstring (date-time)
    Present for a passport read at a point in time (?at=)
• versionsobject[]обов’язкове
  ›Поля

  • subject"product" | "variant" | "batch" | "unit"обов’язкове
  • versionintegerобов’язкове
  • hashstringобов’язкове
  • prevHashstring | nullобов’язкове
  • atstring (date-time)обов’язкове
  • sourcestringобов’язкове
  • changesobject[]обов’язкове
    ›Поля

    • keystringобов’язкове
    • op"add" | "change" | "remove"обов’язкове
    • valueany
    • redactedboolean
  • leavesmap<string, object>
    Leaf hashes (authority level only) to recompute the version hash
    ›Поля

    • hstringобов’язкове
    • access"public" | "legit" | "authority"обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/history'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/history', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/json

PassportAnchorProofs

• codestringобов’язкове
• algorithmstring | nullобов’язкове
• proofsobject[]обов’язкове
  ›Поля

  • subject"product" | "variant" | "batch" | "unit" | "events"обов’язкове
  • versioninteger
  • hashstringобов’язкове
  • anchorobject | nullобов’язкове
    ›Поля

    • daystringобов’язкове
    • rootstringобов’язкове
    • algorithmstringобов’язкове
    • leavesintegerобов’язкове
    • pathobject[]обов’язкове
      ›Поля

      • side"left" | "right"обов’язкове
      • hashstringобов’язкове
    • timestampobject | nullобов’язкове
      ›Поля

      • providerstringобов’язкове
      • atstringобов’язкове
      • digeststringобов’язкове
      • tokenstringобов’язкове
        Base64 RFC 3161 TimeStampResp

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/anchor'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/anchor', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Тіло запиту application/json

• level"legit" | "authority"обов’язкове
• organizationstringобов’язкове
  Authority, service, recycler…
• emailstringобов’язкове
  Contact e-mail for the token (deleted 180 days after the decision)
• justificationstringобов’язкове
  Why the access is needed and on what basis

Відповідь 200 · application/json

PassportAccessRequestCreated

• idstringобов’язкове
• status"new"обов’язкове

Приклад

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."}'

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();

$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);

Параметри

Відповідь 200 · application/pdf, application/octet-stream

Document file

Приклад

curl -X GET 'https://itemoo.eu/q/A1B2C3D4/passport/documents/clx0doc0version0001'

const res = await fetch('https://itemoo.eu/q/A1B2C3D4/passport/documents/clx0doc0version0001', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/linkset+json

Linkset

• linksetmap<string, string | object[]>[]обов’язкове
  One entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)
  ›Поля

  • hrefstringобов’язкове
  • titlestring
  • typestring
  • hreflangstring[]

Приклад

curl -X GET 'https://itemoo.eu/01/05901234123457?linkType=linkset'

const res = await fetch('https://itemoo.eu/01/05901234123457?linkType=linkset', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/linkset+json

Linkset

• linksetmap<string, string | object[]>[]обов’язкове
  One entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)
  ›Поля

  • hrefstringобов’язкове
  • titlestring
  • typestring
  • hreflangstring[]

Приклад

curl -X GET 'https://itemoo.eu/01/05901234123457/10/L2026-10?linkType=linkset'

const res = await fetch('https://itemoo.eu/01/05901234123457/10/L2026-10?linkType=linkset', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/linkset+json

Linkset

• linksetmap<string, string | object[]>[]обов’язкове
  One entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)
  ›Поля

  • hrefstringобов’язкове
  • titlestring
  • typestring
  • hreflangstring[]

Приклад

curl -X GET 'https://itemoo.eu/01/05901234123457/21/SN-0001?linkType=linkset'

const res = await fetch('https://itemoo.eu/01/05901234123457/21/SN-0001?linkType=linkset', {
  method: 'GET',
});
const data = await res.json();

$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);

Параметри

Відповідь 200 · application/linkset+json

Linkset

• linksetmap<string, string | object[]>[]обов’язкове
  One entry: "anchor" (the GS1 URI) and one key per link type (https://gs1.org/voc/pip, …/instructions, …/certificationInfo, …/sustainabilityInfo, …/recallStatus)
  ›Поля

  • hrefstringобов’язкове
  • titlestring
  • typestring
  • hreflangstring[]

Приклад

curl -X GET 'https://itemoo.eu/01/05901234123457/10/L2026-10/21/SN-0001?linkType=linkset'

const res = await fetch('https://itemoo.eu/01/05901234123457/10/L2026-10/21/SN-0001?linkType=linkset', {
  method: 'GET',
});
const data = await res.json();

$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);

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/.well-known/gs1resolver'

const res = await fetch('https://itemoo.eu/.well-known/gs1resolver', {
  method: 'GET',
});
const data = await res.json();

$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);