Skip to content

Fields

Textile / Apparel fields

Every field of a textile 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. ["…"]
date
A string holding a date. "2027-03-01"

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

commodity_codeCommodity code (HS / CN / TARIC)

Customs classification code for this product (6-digit HS, 8-digit EU CN, or 10-digit TARIC). You likely already use this for shipping and import declarations.

Type

text

Format

format_commodity_code POST …/validate warns about a value in another format.

Sources
  • ESPR (Reg (EU) 2024/1781) Annex III(d) anticipated
Access tier

public Public

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
All 15 values
  • reach REACH (EC 1907/2006)
  • eu_ecolabel EU Ecolabel
  • oeko_tex_100 OEKO-TEX Standard 100
  • gots GOTS (Global Organic Textile Standard)
  • iso_14184 EN ISO 14184 — Formaldehyde
  • iso_17075 EN ISO 17075 — Chromium VI
  • en_14682 EN 14682 — Cords & Drawstrings (children)
  • iso_105 ISO 105 — Colour Fastness
  • iso_13934 ISO 13934 — Tensile Strength
  • iso_12947 ISO 12947 — Abrasion Resistance
  • iso_12945 ISO 12945 — Pilling Resistance
  • en_13402 EN 13402 — Size Designation
  • bci BCI (Better Cotton Initiative)
  • grs GRS (Global Recycled Standard)
  • bluesign bluesign®

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.

Material Composition

material_compositionMaterial Composition

Fiber content of your product. Add each fiber type and its percentage (must total 100%).

Type

array

  • fiber The fibre's name, as text.
  • percentage The fibre's share, in %.
  • recycledPercentage How much of this fibre is recycled, in %.
  • country A country code for this fibre: two capital letters, such as PT.
[
  {
    "fiber": "cotton",
    "percentage": 60,
    "recycledPercentage": 20,
    "country": "PT"
  },
  {
    "fiber": "polyester",
    "percentage": 40
  }
]
Publishing

Publishing asks for it.

Sources
  • Reg (EU) 1007/2011 Art. 9 in_force
  • ESPR (Reg (EU) 2024/1781) Annex I(d) anticipated
Access tier

public Public

material_composition_methodComposition Testing Method

How the fibre composition was determined. EN 12127 measures fabric mass per area; it does not determine fibre composition.

Type

select

Listed values
  • iso_1833 ISO 1833 — Quantitative chemical analysis
  • iso_20705 ISO 20705 — Quantitative microscopy
  • iso_17751 ISO 17751 — Animal fibre identification and quantification
  • en_12127 EN 12127 — Mass per unit area
  • manufacturer_declaration Manufacturer declaration
  • supplier_certificate Supplier certificate
  • other Other

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

Access tier

restricted Restricted

material_componentsComponent breakdown (optional)

Optional per-component fibre breakdown (e.g. Shell, Lining, Trim) for multi-component products. The flat material composition above stays the source of truth; this only adds detail.

Type

array

  • component The name of a part of the product, such as Shell or Lining.
  • fibers The part's fibres. Each entry has the keys fiber, percentage and recycledPercentage, as in material_composition.
[
  {
    "component": "Shell",
    "fibers": [
      {
        "fiber": "cotton",
        "percentage": 100
      }
    ]
  },
  {
    "component": "Lining",
    "fibers": [
      {
        "fiber": "polyester",
        "percentage": 100
      }
    ]
  }
]
Sources
  • Reg (EU) 1007/2011 Art. 11 in_force
  • ESPR (Reg (EU) 2024/1781) Annex I(d) anticipated
Access tier

public Public

pfas_declarationPFAS Declaration

Whether PFAS (per- and polyfluoroalkyl substances) were intentionally added. France's restrictions on PFAS in clothing and footwear apply from 1 January 2026, subject to concentration limits, exemptions and transitional rules.

Leaving this empty means "not declared". Check supplier evidence before declaring no intentional addition. This does not establish absence of PFAS or legal compliance.

Type

select

Listed values
  • no_intentionally_added No intentionally added PFAS
  • contains_intentionally_added Contains intentionally added PFAS

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

Access tier

public Public

microfibre_sheddingMicrofibre release

Whether this product releases plastic microfibres when washed. Required for products over 50% synthetic fibres under France's AGEC law (for in-scope sellers).

Type

select

Listed values
  • released Releases plastic microfibres when washed
  • not_applicable Not applicable (not predominantly synthetic)
  • unknown Unknown / not assessed

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

Sources
  • AGEC Décret 2022-748 microfibre FR in_force_conditional

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

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

public Public

net_weight_gramsNet Weight

Finished-product net weight in grams. Also the "mass" input for France's coût environnemental (Ecobalyse) score.

Weigh the finished product without packaging.

Type

number

Unit of measurement

g

Limits

min: 1

Access tier

public Public

Care Instructions

care_instructions_textCare Instructions (Text)

Human-readable care instructions as free text

Type

text

Access tier

public Public

care_instructionsCare Instructions

Select the care symbols that apply to your product.

Type

array item_type: string

Listed values
All 30 values
  • machine_wash_30 Machine wash 30°C
  • machine_wash_40 Machine wash 40°C
  • machine_wash_50 Machine wash 50°C
  • machine_wash_60 Machine wash 60°C
  • machine_wash_95 Machine wash 95°C
  • gentle_wash_30 Gentle machine wash 30°C
  • gentle_wash_40 Gentle machine wash 40°C
  • very_gentle_wash_30 Very gentle machine wash 30°C
  • hand_wash Hand wash
  • do_not_wash Do not wash
  • any_bleach Bleach (any bleach allowed)
  • non_chlorine_bleach Non-chlorine bleach only
  • do_not_bleach Do not bleach
  • tumble_dry_normal Tumble dry, normal heat
  • tumble_dry_low Tumble dry, low heat
  • tumble_dry_high Tumble dry, high heat
  • do_not_tumble_dry Do not tumble dry
  • line_dry Line dry (hang to dry)
  • flat_dry Dry flat
  • drip_dry Drip dry
  • iron_low Iron, low temperature (max 110°C)
  • iron_medium Iron, medium temperature (max 150°C)
  • iron_high Iron, high temperature (max 200°C)
  • do_not_iron Do not iron
  • no_steam Iron without steam
  • dry_clean_any Dry clean (any solvent)
  • dry_clean_petroleum Dry clean, petroleum solvent only
  • do_not_dry_clean Do not dry clean
  • wet_clean Professional wet cleaning
  • do_not_wet_clean Do not wet clean

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

Access tier

public Public

safety_informationSafety information / warnings

Any safety warnings or precautions a consumer needs (e.g. choking-hazard cords on childrenswear, flammability notes, allergen finishes). Leave empty if the product is safe without instructions.

Type

text

Sources
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(f) anticipated
Access tier

public Public

Manufacturing Details

country_of_manufactureCountry of Manufacture

Select the country where the product was made.

Type

text

Format

format_country_code Publishing refuses a value in another format.

Sources
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

Access tier

public Public

manufacturing_dateManufacturing date

Date on which this item or batch was manufactured

Type

date

Access tier

restricted Restricted

batch_numberBatch Number

Production batch identifier for traceability

Type

text

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

restricted Restricted

country_of_spinningCountry of Spinning

Select the country where the yarn was spun (used by France's coût environnemental calculation).

Type

text

Format

format_country_code Publishing refuses a value in another format.

Sources
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

Access tier

public Public

country_of_weaving_knittingCountry of Weaving/Knitting

Select the country where weaving or knitting mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.

Type

text

Format

format_country_code Publishing refuses a value in another format.

Sources
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

Access tier

public Public

country_of_dyeing_printingCountry of Dyeing/Printing

Select the country where dyeing or printing mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.

Type

text

Format

format_country_code Publishing refuses a value in another format.

Sources
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

Access tier

public Public

country_of_confectionCountry of Confection (Assembly)

Select the country where garment assembly mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.

Type

text

Format

format_country_code Publishing refuses a value in another format.

Sources
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

Access tier

public Public

number_of_referencesNumber of References

For France's environmental-cost calculation, enter your brand's maximum number of clothing references offered on the same day during the calendar year, within this product's market segment. Count each product/colour once across all sizes. Apply the official sales-channel and exclusion rules.

Type

number

Limits

min: 1 max: 999999

Sources
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

Access tier

restricted Restricted

priceRetail price (€)

Unit retail price in euros including VAT, excluding promotions and sales, on the reference sales channel used for France's environmental-cost calculation.

Feeds the France filing only — it is never shown on the public passport.

Type

number

Limits

min: 1 max: 1000

Sources
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

Access tier

restricted Restricted

epr_registration_numberEPR Producer Registration Number

Your producer registration number under an EU textile Extended Producer Responsibility (EPR) scheme.

For France this is your ADEME Unique Identification Number (UIN).

Type

text

Access tier

public Public

Durability & Repairability

expected_lifetime_wearsExpected Lifetime (Wears)

Estimated number of wears under normal use conditions

Type

number

Limits

min: 1

Access tier

public Public

repairability_scoreRepairability Score

Kept for values already entered; no longer asked.

Type

number

Limits

min: 0 max: 10

Access tier

public Public

Held back from the public passport page. self_declared_label

repair_instructions_urlRepair Instructions URL

Link to repair guides, spare parts, or service centers — or upload the file.

Type

url

Access tier

public Public

A document can stand in

document

Its id is sent in repair_instructions_url__document_id.