Kategoriler

curl "https://passportcraft.com/api/v1/categories"

{
  "object": "list",
  "data": [
    {
      "object": "category",
      "id": "general",
      "name": "categories/general",
      "display_name": "General Product",
      "schema_version": "1.0.0-draft",
      "field_count": 28
    },
    {
      "object": "category",
      "id": "textile",
      "name": "categories/textile",
      "display_name": "Textile / Apparel",
      "schema_version": "1.0.0-draft",
      "field_count": 51
    },
    {
      "object": "category",
      "id": "battery",
      "name": "categories/battery",
      "display_name": "Battery",
      "schema_version": "1.0.0-draft",
      "field_count": 99
    }
  ],
  "has_more": false,
  "next_cursor": null
}

curl "https://passportcraft.com/api/v1/categories/battery/schema"

{
  "object": "category_schema",
  "id": "battery",
  "name": "categories/battery/schema",
  "category": "battery",
  "display_name": "Battery",
  "schema_version": "1.0.0-draft",
  "field_groups": [
    {
      "object": "field_group",
      "id": "identification",
      "label": "Product Identification",
      "description": "Core identifiers and descriptors for the product"
    },
    {
      "object": "field_group",
      "id": "manufacturer",
      "label": "Manufacturer / Economic Operator",
      "description": "Details of the manufacturer or EU responsible person"
    },
    {
      "object": "field_group",
      "id": "sustainability",
      "label": "Environmental Data",
      "description": "Carbon footprint and material recycling data"
    },
    {
      "object": "field_group",
      "id": "compliance",
      "label": "Regulatory Compliance",
      "description": "Substances of concern and conformity declarations"
    },
    {
      "object": "field_group",
      "id": "end_of_life",
      "label": "End of Life",
      "description": "Recycling and disposal guidance for the product"
    },
    {
      "object": "field_group",
      "id": "circular_economy",
      "label": "Circular Economy",
      "description": "Recyclability, disassembly, and end-of-life information"
    },
    {
      "object": "field_group",
      "id": "identifiers_product",
      "label": "Battery Identification & Product Data",
      "description": "These you'll know from your own product and paperwork — your model name, where it's made, your warranty, and the IDs your manufacturer gives you."
    },
    {
      "object": "field_group",
      "id": "labels_conformity",
      "label": "Labels, Symbols & Conformity",
      "description": "Use the labels, safety information and conformity documents for this battery model. Ask the manufacturer or your compliance team for the supporting documents."
    },
    {
      "object": "field_group",
      "id": "carbon_footprint",
      "label": "Carbon Footprint",
      "description": "Obtain the carbon-footprint documentation for this battery model and manufacturing plant from the manufacturer or an LCA (life-cycle assessment) provider. Timing depends on the battery category, the information requested and the relevant EU acts."
    },
    {
      "object": "field_group",
      "id": "due_diligence",
      "label": "Supply-Chain Due Diligence",
      "description": "Ask your supply-chain team for your battery due-diligence report. These obligations start on 18 August 2027. One exemption applies if your net turnover was below €40 million in the financial year before the last one and you are not part of a group whose consolidated turnover exceeds €40 million."
    },
    {
      "object": "field_group",
      "id": "materials",
      "label": "Materials & Composition",
      "description": "Use the manufacturer's material and substance declarations for this battery model, supported by the relevant cell documentation."
    },
    {
      "object": "field_group",
      "id": "circularity",
      "label": "Circularity & Resource Efficiency",
      "description": "Use the manufacturer's repair and safety documents and the collection scheme's information. Recycled-content timing depends on the battery category and the relevant EU acts; renewable-content information is separate."
    },
    {
      "object": "field_group",
      "id": "performance",
      "label": "Performance & Durability",
      "description": "Use the technical documentation for the battery model and configuration covered by this passport. Ask the manufacturer or technical team to confirm missing values and test conditions; cell data does not automatically describe the assembled battery."
    }
  ],
  "per_battery_fields": [
    {
      "object": "field",
      "name": "status",
      "type": "select",
      "required": true,
      "per_battery": "only",
      "required_from": "2027-02-18",
      "access_tier": "public",
      "group": "performance",
      "label": "Battery status",
      "description": "Record this battery’s current status.",
      "options": [
        {
          "value": "original",
          "label": "Original"
        },
        {
          "value": "repurposed",
          "label": "Repurposed"
        },
        {
          "value": "re-used",
          "label": "Re-used"
        },
        {
          "value": "remanufactured",
          "label": "Remanufactured"
        },
        {
          "value": "waste",
          "label": "Waste"
        }
      ],
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(c)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "The five status values are named in Annex XIII(4)(c). Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "state_of_certified_energy",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "ev"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "State of certified energy",
      "description": "Record this battery’s state of certified energy as a percentage.",
      "unit": "%",
      "min": 0,
      "max": 100,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Art. 14(1) -> Annex VII Part A",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Annex VII Part A names state of certified energy for EV batteries. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "remaining_capacity",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "lmt",
          "industrial_stationary"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Remaining capacity",
      "description": "Record the capacity this battery can still deliver.",
      "unit": "Ah",
      "unit_field": "rated_capacity_unit",
      "default_unit": "Ah",
      "min": 0,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Art. 14(1) -> Annex VII Part A(1)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Article 14(1) names LMT and stationary battery energy storage systems. The guidance marks industrial data if applicable. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "remaining_power_capability",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "lmt"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Remaining power capability",
      "description": "Record the power this battery can still deliver, in watts.",
      "unit": "W",
      "min": 0,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Annex VII Part A(2)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Annex VII Part A(2) says where possible; the non-binding category guidance marks LMT mandatory. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "remaining_round_trip_efficiency",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "lmt"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Remaining round-trip efficiency",
      "description": "Record this battery’s remaining round-trip efficiency as a percentage.",
      "unit": "%",
      "min": 0,
      "max": 100,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Annex VII Part A(3)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Annex VII Part A(3) says where possible; the non-binding category guidance marks LMT mandatory. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "self_discharge_rate",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "lmt",
          "industrial_stationary"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Self-discharge rate",
      "description": "Record this battery’s self-discharge rate as a percentage per month. Dated readings show how it changes over time.",
      "unit": "%/month",
      "min": 0,
      "max": 100,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Art. 14(1) -> Annex VII Part A(4)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Annex VII Part A(4) asks for the evolution of self-discharge rates; the dated log represents that evolution. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "ohmic_resistance",
      "type": "number",
      "required": true,
      "per_battery": "only",
      "required_when": {
        "field": "battery_category",
        "one_of": [
          "lmt"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Ohmic resistance",
      "description": "Record the resistance measured for this battery pack.",
      "unit": "Ohm",
      "unit_field": "initial_internal_resistance_pack_unit",
      "default_unit": "Ohm",
      "min": 0,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(b) -> Annex VII Part A(5)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Annex VII Part A(5) says where possible; the non-binding category guidance marks LMT mandatory. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "charge_discharge_cycles",
      "type": "number",
      "required": false,
      "per_battery": "only",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Charge and discharge cycles",
      "description": "Record the number of charge and discharge cycles completed by this battery.",
      "min": 0,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(d)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Usage data, if applicable; fractional equivalent cycles may be recorded. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "negative_events",
      "type": "text",
      "required": false,
      "per_battery": "only",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Negative events",
      "description": "Describe events that affected this battery, such as an accident.",
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(d)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Usage data, if applicable; Annex XIII(4)(d) names negative events such as accidents. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "temperature",
      "type": "number",
      "required": false,
      "per_battery": "only",
      "access_tier": "restricted",
      "group": "performance",
      "label": "Temperature",
      "description": "Record this battery’s temperature in degrees Celsius.",
      "unit": "°C",
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(d)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Usage data, if applicable; this is a single dated temperature, not the model's idle temperature range. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    },
    {
      "object": "field",
      "name": "state_of_charge",
      "type": "number",
      "required": false,
      "per_battery": "only",
      "access_tier": "restricted",
      "group": "performance",
      "label": "State of charge",
      "description": "Record this battery’s state of charge as a percentage.",
      "unit": "%",
      "min": 0,
      "max": 100,
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Annex XIII(4)(d)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Usage data, if applicable; this is a dated reading. Annex XIII point 4 is individual-battery data routed by Art. 77(2)(c) to persons with a legitimate interest only; unlike points 2 and 3 it does not name the Commission. Arguably belongs in the unit layer."
        }
      ]
    }
  ],
  "fields": [
    {
      "object": "field",
      "name": "placed_on_market_by",
      "type": "select",
      "required": true,
      "required_from": "2027-02-18",
      "access_tier": "public",
      "group": "manufacturer",
      "label": "Who places this battery on the EU market?",
      "description": "The company that places the battery on the EU market is responsible for keeping its passport accurate and up to date.",
      "options": [
        {
          "value": "manufacturer",
          "label": "The manufacturer named in this passport"
        },
        {
          "value": "importer",
          "label": "An importer established in the EU"
        }
      ],
      "requirement": "required",
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Art. 77(4)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "The economic operator placing the battery on the market ensures the passport is accurate, complete and up to date. The Commission guidance v2.0 lists the identity of whoever is responsible for the passport as mandatory for every category (data point 2); no Annex XIII item names it."
        }
      ]
    },
    {
      "object": "field",
      "name": "product_name",
      "type": "text",
      "required": true,
      "access_tier": "public",
      "group": "identification",
      "label": "Product Name",
      "description": "Commercial name of the product",
      "hint": "Shown as the headline on the public passport and in search.",
      "requirement": "required",
      "functional_basis": "Record identity — the passport cannot identify its product without a name.",
      "regulatory_basis": [
        {
          "regulation": "ESPR (Reg (EU) 2024/1781)",
          "reference": "Annex III(a)",
          "status": "anticipated",
          "note": "Product identifier/name — DA-gated for textiles."
        }
      ]
    },
    {
      "object": "field",
      "name": "recyclable_content_percentage",
      "type": "number",
      "required": false,
      "access_tier": "public",
      "group": "sustainability",
      "label": "Recyclable Content (%)",
      "description": "Percentage of the product that is recyclable at end of life",
      "min": 0,
      "max": 100
    },
    {
      "object": "field",
      "name": "conformity_declaration_url",
      "type": "url",
      "required": false,
      "access_tier": "authority",
      "group": "compliance",
      "label": "Declaration of Conformity URL",
      "description": "Link to the EU Declaration of Conformity document, or upload the PDF.",
      "document_types": [
        "conformity_declaration"
      ],
      "document_id_key": "conformity_declaration_url__document_id"
    },
    {
      "object": "field",
      "name": "substances_of_concern",
      "type": "array",
      "required": true,
      "access_tier": "public",
      "group": "compliance",
      "label": "Substances of Concern",
      "description": "List of substances of concern present above threshold concentrations, or \"none declared\"",
      "item_type": "string",
      "requirement": "required",
      "regulatory_basis": [
        {
          "regulation": "REACH (Reg (EC) 1907/2006)",
          "reference": "Art. 33",
          "status": "in_force",
          "note": "Communicate SVHCs > 0.1% w/w per article."
        },
        {
          "regulation": "SCIP / WFD (Dir 2008/98/EC)",
          "reference": "Art. 9(1)(i)",
          "status": "in_force",
          "note": "SCIP notification; repeal proposed (Environmental Omnibus COM(2025) 986) — re-check quarterly.",
          "status_changing": true
        },
        {
          "regulation": "ESPR (Reg (EU) 2024/1781)",
          "reference": "Art. 7(5)",
          "status": "anticipated"
        }
      ]
    },
    {
      "object": "field",
      "name": "eu_importer",
      "type": "text",
      "required": true,
      "required_when": {
        "field": "placed_on_market_by",
        "one_of": [
          "importer"
        ]
      },
      "required_from": "2027-02-18",
      "access_tier": "public",
      "group": "manufacturer",
      "label": "EU Importer",
      "description": "The importer's name, registered trade name or trade mark, and postal address, when a company other than you places the product on the EU market.",
      "hint": "The importer is a distinct economic operator from the manufacturer — the EU-established business that brings the product into the Union.",
      "requirement": "required",
      "regulatory_basis": [
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Art. 77(4)",
          "status": "applies_later",
          "applies_when": "LMT, industrial >2 kWh and EV batteries placed on the market or put into service from 18 Feb 2027 (Art. 77(1))",
          "note": "Where an importer places the battery on the market, it is the operator responsible for the passport. Guidance v2.0 data point 2."
        },
        {
          "regulation": "Batteries Reg (EU) 2023/1542",
          "reference": "Art. 41(3)",
          "status": "in_force",
          "note": "The importer indicates on the battery its name, registered trade name or registered trade mark and postal address — the items this field asks for."
        }
      ]
    }
  ]
}