Portable battery field reference

Field reference for portable battery passports from GET /api/dpp/{slug}. Portable batteries cover consumer-replaceable and built-in batteries in everyday devices, such as power banks, power tools, and household electronics.

The portable category is identified on the DPP by categoryId (cat_bat_5) and its resolvable category_code (BAT-PORT-001), not by a *_BATTERY enum. In the JSON-LD output, dpp:productCategory is "Portable Battery". See Battery categories for the category list.

For fields shared across all categories, see DPP overview. This page documents what is specific to, or different for, portable batteries.

---

The Digital Product Passport is voluntary for portable batteries

This is the most important difference from the EV, LMT, and Industrial categories.

Under EU Battery Regulation 2023/1542, the mandatory Digital Product Passport obligation applies to LMT batteries, industrial batteries above 2 kWh, and EV batteries. Portable batteries are not in scope of the mandatory DPP requirement. A portable battery DPP on Traceable is therefore a voluntary passport.

Two consequences for integrators:

1. Most fields are optional. Because there is no mandatory field set to enforce, you cannot assume any compliance, carbon footprint, or performance field is present. The DPP body drops empty values, so guard against absent keys.
2. Carbon footprint is not required. Unlike EV and LMT batteries, portable batteries commonly have no carbonFootprint value. When present it is a single number. Treat its presence as a bonus, not a guarantee.

---

Portable template fields

The DPP body is a configuration-driven object, not a fixed schema, and the keys at the top level are the ones described in the DPP overview. The portable template includes these field identifiers, which appear in the public response only where the field is public and populated:

Field identifier	Meaning	Notes
battery_category	Battery category label
removable_by_user	Whether the user can remove the battery themselves	Yes or no
weee_symbol_present	Whether the battery carries the crossed-out bin symbol	Yes or no
non_rechargeable	Whether this is a non-rechargeable (primary) battery	Shown only when the operator declared it
weight_kg	Weight	Kilograms
chemistry	Battery chemistry	For example Li-ion, Li-Polymer, NiMH
nominal_voltage_v	Nominal voltage	Volts
capacity_mah	Capacity	Milliamp-hours
energy_capacity_wh	Energy capacity	Watt-hours

There is no batteryCategory, status, performance or removability key on the DPP body. The portable template does not carry a battery status field.

---

Removability and replaceability (Article 11)

EU Battery Regulation Article 11 requires that portable batteries in many product types be removable and replaceable by the end user. The portable template records whether the user can remove the battery in the removable_by_user field. Treat it as optional:

const dpp = await fetchDpp('example-power-bank-slug');

if (dpp.categoryId === 'cat_bat_5') {
  const removable = dpp.formData?.removable_by_user;
  if (removable === undefined || removable === null) {
    console.log('User-removability not declared');
  } else {
    // Log the declared value as received; do not assume its type.
    console.log('User-removable (as declared):', removable);
  }
}

---

Capacity units

Portable batteries are rated in milliamp-hours (capacity_mah) and watt-hours (energy_capacity_wh), not kilowatt-hours as used for EV and LMT batteries. Do not assume a kWh scale when displaying portable capacity.

---

Carbon footprint (handle as optional)

Unlike EV and LMT batteries, do not assume carbonFootprint is present for portable batteries. When it is present it is a single number, not a nested object:

const dpp = await fetchDpp('example-power-bank-slug');

if (dpp.categoryId !== 'cat_bat_5') {
  throw new Error('Expected a portable battery (cat_bat_5)');
}

const cf = dpp.carbonFootprint;
if (typeof cf === 'number') {
  console.log(`Carbon footprint: ${cf}`);
} else {
  console.log('Carbon footprint not declared (not required for portable batteries)');
}

---

Restricted fields (PoLI access only)

As with other categories, detailed supply chain fields (raw material sourcing detail, internal audit references, full supplier identity data) are omitted from the public API response and are accessible only to entities with approved PoLI access. See PoLI endpoints and the PoLI access flow example.