Skip to content

Fields

General Product 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.

Types

text
A string. "…" Some text fields also check the format. Their row names the check.
multiselect
A list of strings. ["EU"]
url
A string holding a web address. "https://example.com/document.pdf"
number
A number. 50
select
A string. "kg_co2e"
array
A list. Its row names what each entry holds. ["…"]

Product Identification

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

public Public

gtinGTIN

Already 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.

Type

text

Format

format_gtin Publishing refuses a value in another format.

Publishing

Publishing asks for it.

A saved size or colour with its own barcode also counts.

Sources
  • GS1 / GTIN GS1 General Specifications voluntary
  • ESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipated

The status is the endpoint's own classification.

Access tier

public Public

serial_numberSerial Number

Item-level serial number for unit-specific identification

Type

text

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
Access tier

public Public

product_descriptionProduct Description

A clear description of the product and its intended use

Type

text

Publishing

Publishing asks for it.

Access tier

public Public

product_categoryProduct Category

General product type (e.g. T-Shirt, Jacket, Bedding). Optional — helps organize your passports.

Type

text

Access tier

public Public

markets_sold_intoMarkets sold into

Where 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.

Type

multiselect

Listed values
All 11 values
  • EU European Union / EEA (general)
  • FR France
  • DE Germany
  • IT Italy
  • ES Spain
  • NL Netherlands
  • BE Belgium
  • PL Poland
  • UK United Kingdom
  • US United States
  • OTHER Other / rest of world

Publishing can refuse a value outside the list. POST …/validate tells you which.

Access tier

restricted Restricted

Manufacturer / Economic Operator

manufacturer_nameManufacturer Name

The manufacturer's name, registered trade name or registered trade mark.

Type

text

Publishing

Publishing asks for it.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Access tier

public Public

manufacturer_addressManufacturer Address

The manufacturer's postal address. If a single contact point has a different postal address, add it too.

Type

text

Publishing

Publishing asks for it.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Access tier

public Public

manufacturer_countryManufacturer Country

Select the manufacturer's country.

Type

text

Format

format_country_code Publishing refuses a value in another format.

Publishing

Publishing asks for it.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
Access tier

public Public

manufacturer_emailManufacturer Email

The 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.

Type

text

Format

format_email Publishing refuses a value in another format.

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditional

    Conditions apply. The endpoint returns them in regulatory_basis[].applies_when.

Access tier

public Public

eori_numberEORI Number

Economic Operators Registration and Identification number for EU customs

Type

text

Format

format_eori Publishing refuses a value in another format.

Access tier

restricted Restricted

eu_responsible_personEU Responsible Person

Name 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

Type

text

Sources
  • GPSR (Reg (EU) 2023/988) Art. 16(1) in_force
  • Market Surveillance Reg (EU) 2019/1020 Art. 4 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(k) anticipated
Access tier

public Public

eu_importerEU Importer

When 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.

Type

text

Sources
  • GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditional

    Conditions apply. The endpoint returns them in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipated
  • ESPR (Reg (EU) 2024/1781) Annex III(j) anticipated
Access tier

public Public

Environmental Data

carbon_footprint_valueCarbon Footprint

Product carbon footprint. Choose the matching unit of measurement in the selector.

Type

number

Unit of measurement

Sent in carbon_footprint_unit.

carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2

Access tier

public Public

carbon_footprint_unitCarbon footprint: unit of measurement

Unit of measurement for the carbon footprint value.

Type

select

Listed values
  • 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.

Access tier

public Public

carbon_footprint_basisCarbon Footprint Basis

How the carbon footprint was calculated.

This records the calculation method. Keep supporting evidence for the footprint; selecting a method does not substantiate the result.

Type

select

Listed values
  • iso_14067 ISO 14067 (product carbon footprint)
  • pef EU PEF / PEFCR
  • ghg_protocol GHG Protocol Product Standard
  • iso_14040_44 ISO 14040/44 LCA
  • supplier_data Supplier-provided / EPD data
  • estimate Internal estimate

Publishing can refuse a value outside the list. POST …/validate tells you which.

Sources
  • UCPD (Dir 2005/29/EC) Art. 12 in_force
Access tier

public Public

recyclable_content_percentageRecyclable Content (%)

Percentage of the product that is recyclable at end of life

Type

number

Limits

min: 0 max: 100

Access tier

public Public

recycled_content_percentageRecycled Content (%)

Percentage of the product made from recycled materials

Type

number

Limits

min: 0 max: 100

Sources
  • AGEC Décret 2022-748 recycled-material % FR in_force_conditional

    Conditions apply. The endpoint returns them in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Annex I(h) anticipated
Access tier

public Public

Regulatory Compliance

substances_of_concernSubstances of Concern

List of substances of concern present above threshold concentrations, or "none declared"

Type

array item_type: string

Sources
  • REACH (Reg (EC) 1907/2006) Art. 33 in_force
  • SCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_force
  • AGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditional

    Conditions apply. The endpoint returns them in regulatory_basis[].applies_when.

  • ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipated
Access tier

public Public

conformity_declaration_urlDeclaration of Conformity URL

Link to the EU Declaration of Conformity document, or upload the PDF.

Type

url

Access tier

authority Authority only

A document can stand in

conformity_declaration

Its id is sent in conformity_declaration_url__document_id.

compliance_standardsCompliance Standards

Select the standards your product complies with.

Type

multiselect

Listed values
  • reach REACH (EC 1907/2006)
  • eu_ecolabel EU Ecolabel

Publishing can refuse a value outside the list. POST …/validate tells you which.

Access tier

public Public

End of Life

recycling_instructionsRecycling Instructions

Instructions for recycling the product at end of life

Type

text

Access tier

public Public

disposal_instructionsDisposal Instructions

Instructions for safe disposal if the product cannot be recycled

Type

text

Access tier

public Public

Circular Economy

mono_material_percentageMono-material Percentage

Percentage of product made from a single recyclable material (0-100). Products above 85% are significantly easier to recycle.

Type

number

Limits

min: 0 max: 100

Access tier

public Public

recyclability_gradeRecyclability Grade

Kept for values already entered; no longer asked.

Type

select

Listed values
  • 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.

Access tier

public Public

Held back from the public passport page. self_declared_label

disassembly_instructions_urlDisassembly Instructions

URL to a guide for separating non-recyclable components (zippers, buttons, coatings) for recycling — or upload the file.

Type

url

Access tier

public Public

A document can stand in

document

Its id is sent in disassembly_instructions_url__document_id.

takeback_scheme_urlTake-back Scheme

URL to collection or take-back program information — or upload the file.

Type

url

Sources
  • ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipated
Access tier

public Public

A document can stand in

document

Its id is sent in takeback_scheme_url__document_id.