product_nameProduct Name
Commercial name of the product
Shown as the headline on the public passport and in search.
- Type
text- Publishing
Publishing asks for it.
- Access tier
publicPublic
Nothing matches that.
Fields
Every field of a general product passport: what it is, how to send it and what publishing asks for.
This page lists every field that GET /categories/{category}/schema returns. Some rows add what the endpoint does not return, such as the format a text value must have, the care symbols a field accepts or the keys of a list's entries. They come from the API's own code. The endpoint also returns the conditions and notes behind each legal reference. This page does not list each category's own checks. Such a check can still ask for a field, even when the field's row shows no publishing line, or shows an exception that applies to your product. A check can also refuse a value. POST …/validate runs these checks on your passport and names each problem it finds.
Paths, methods, scopes, field names, error codes and validation rule names are published in English, because English is the language of the interface itself — they are what a caller types or matches on. So is every code sample and JSON payload, and the exact sentence an error response carries: /v1 does not read Accept-Language, so translating what the API literally sends would misdescribe it. Everything written about them follows the language of this page.
text"…" Some text fields also check the format. Their row names the check.multiselect["EU"]url"https://example.com/document.pdf"number50select"kg_co2e"array["…"]product_nameProduct NameCommercial name of the product
Shown as the headline on the public passport and in search.
text
Publishing asks for it.
public Public
gtinGTINAlready have a barcode? The number under it is your GTIN. Required to publish.
The GTIN links the digital passport to the physical barcode on the label.
text
format_gtin Publishing refuses a value in another format.
Publishing asks for it.
A saved size or colour with its own barcode also counts.
GS1 / GTIN GS1 General Specifications voluntaryESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipatedThe status is the endpoint's own classification.
public Public
serial_numberSerial NumberItem-level serial number for unit-specific identification
text
GPSR (Reg (EU) 2023/988) Art. 9 in_forcepublic Public
product_descriptionProduct DescriptionA clear description of the product and its intended use
text
Publishing asks for it.
public Public
product_categoryProduct CategoryGeneral product type (e.g. T-Shirt, Jacket, Bedding). Optional — helps organize your passports.
text
public Public
markets_sold_intoMarkets sold intoWhere this product is placed on the market. Determines which market-specific rules (e.g. France AGEC) apply. Select France (FR) specifically if you sell there.
Used only to tailor compliance guidance — never shown on the public passport.
multiselect
EU European Union / EEA (general)FR FranceDE GermanyIT ItalyES SpainNL NetherlandsBE BelgiumPL PolandUK United KingdomUS United StatesOTHER Other / rest of worldPublishing can refuse a value outside the list. POST …/validate tells you which.
restricted Restricted
manufacturer_nameManufacturer NameThe manufacturer's name, registered trade name or registered trade mark.
text
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_addressManufacturer AddressThe manufacturer's postal address. If a single contact point has a different postal address, add it too.
text
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_countryManufacturer CountrySelect the manufacturer's country.
text
format_country_code Publishing refuses a value in another format.
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_emailManufacturer EmailThe manufacturer's electronic address, such as an email address.
Where the General Product Safety Regulation applies, it asks manufacturers for a postal and an electronic address.
text
format_email Publishing refuses a value in another format.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
manufacturer_websiteManufacturer WebsiteThe manufacturer's website.
url
public Public
eori_numberEORI NumberEconomic Operators Registration and Identification number for EU customs
text
format_eori Publishing refuses a value in another format.
restricted Restricted
eu_responsible_personEU Responsible PersonName and contact of the EU-based responsible person — needed to sell in the EU when the manufacturer is outside it, unless you name an EU importer instead
text
GPSR (Reg (EU) 2023/988) Art. 16(1) in_forceMarket Surveillance Reg (EU) 2019/1020 Art. 4 in_forceESPR (Reg (EU) 2024/1781) Annex III(k) anticipatedpublic Public
eu_importerEU ImporterWhen a company other than you places the product on the EU market, enter that importer here. Give its name, registered trade name or registered trade mark, its postal address and an electronic address, such as an email address.
The importer is a distinct economic operator from the manufacturer — the EU-established business that brings the product into the Union.
text
GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipatedESPR (Reg (EU) 2024/1781) Annex III(j) anticipatedpublic Public
carbon_footprint_valueCarbon FootprintProduct carbon footprint. Choose the matching unit of measurement in the selector.
number
Sent in carbon_footprint_unit.
carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2
public Public
carbon_footprint_unitCarbon footprint: unit of measurementUnit of measurement for the carbon footprint value.
select
kg_co2e kg CO₂e (per unit)kg_co2e_per_kg kg CO₂e / kg (per weight)kg_co2e_per_m2 kg CO₂e / m² (per area)Publishing can refuse a value outside the list. POST …/validate tells you which.
public Public
carbon_footprint_basisCarbon Footprint BasisHow the carbon footprint was calculated.
This records the calculation method. Keep supporting evidence for the footprint; selecting a method does not substantiate the result.
select
iso_14067 ISO 14067 (product carbon footprint)pef EU PEF / PEFCRghg_protocol GHG Protocol Product Standardiso_14040_44 ISO 14040/44 LCAsupplier_data Supplier-provided / EPD dataestimate Internal estimatePublishing can refuse a value outside the list. POST …/validate tells you which.
UCPD (Dir 2005/29/EC) Art. 12 in_forcepublic Public
recyclable_content_percentageRecyclable Content (%)Percentage of the product that is recyclable at end of life
number
min: 0 max: 100
public Public
recycled_content_percentageRecycled Content (%)Percentage of the product made from recycled materials
number
min: 0 max: 100
AGEC Décret 2022-748 recycled-material % FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Annex I(h) anticipatedpublic Public
substances_of_concernSubstances of ConcernList of substances of concern present above threshold concentrations, or "none declared"
array item_type: string
REACH (Reg (EC) 1907/2006) Art. 33 in_forceSCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_forceAGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipatedpublic Public
conformity_declaration_urlDeclaration of Conformity URLLink to the EU Declaration of Conformity document, or upload the PDF.
url
authority Authority only
conformity_declaration
Its id is sent in conformity_declaration_url__document_id.
compliance_standardsCompliance StandardsSelect the standards your product complies with.
multiselect
reach REACH (EC 1907/2006)eu_ecolabel EU EcolabelPublishing can refuse a value outside the list. POST …/validate tells you which.
public Public
recycling_instructionsRecycling InstructionsInstructions for recycling the product at end of life
text
public Public
disposal_instructionsDisposal InstructionsInstructions for safe disposal if the product cannot be recycled
text
public Public
mono_material_percentageMono-material PercentagePercentage of product made from a single recyclable material (0-100). Products above 85% are significantly easier to recycle.
number
min: 0 max: 100
public Public
recyclability_gradeRecyclability GradeKept for values already entered; no longer asked.
select
A A — Fully recyclable (mono-material, no contaminants)B B — Recyclable with separation (removable non-recyclable parts)C C — Partially recyclable (blended, some components recoverable)D D — Difficult to recycle (complex blends, coatings)E E — Not recyclable (inseparable materials or contaminating components)Publishing can refuse a value outside the list. POST …/validate tells you which.
public Public
Held back from the public passport page. self_declared_label
disassembly_instructions_urlDisassembly InstructionsURL to a guide for separating non-recyclable components (zippers, buttons, coatings) for recycling — or upload the file.
url
public Public
document
Its id is sent in disassembly_instructions_url__document_id.
takeback_scheme_urlTake-back SchemeURL to collection or take-back program information — or upload the file.
url
ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipatedpublic Public
document
Its id is sent in takeback_scheme_url__document_id.