Skip to content
HALOWERK

Rechenwerk

packaging volumes

Multiplies units by component grams and assigns each packaging to the material types of § 42(2) VerpackDG (glass, paper/board, ferrous metals, aluminium, beverage cartons, other composites, plastics; other materials combined, § 9(1)). Components marked as bonded form one unit: for calendar year 2026 the breakdown follows § 3(5) and § 16(3) VerpackG in the version until 11 August 2026 (§ 68(5) VerpackDG: composite unless the main material exceeds 95 %); from 2027 the composite definition of.

POST https://rechen.halowerk.com/v1/packaging-volumes

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
reporting_yearintegerYesCalendar year of the quantities (2026 or later).
itemsarrayYes
previous_year_system_kgnumberNoMass of system-participation packaging in the previous year, for the 10 t rule of § 9(2).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "reporting_year",
    "items"
  ],
  "properties": {
    "reporting_year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Calendar year of the quantities (2026 or later)."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "units",
          "packaging_type",
          "typically_private_final_consumer",
          "components"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "Article or packaging reference."
          },
          "units": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000000000,
            "description": "Packaging units made available in Germany in the year."
          },
          "packaging_type": {
            "type": "string",
            "enum": [
              "sales",
              "grouped",
              "transport",
              "service",
              "ecommerce",
              "primary_production"
            ],
            "description": "sales, grouped (Umverpackung), transport, service (filled at the point of sale), ecommerce (shipping), primary_production."
          },
          "typically_private_final_consumer": {
            "type": "boolean",
            "description": "Typically ends up as waste mainly at private households or comparable sources (§ 3(6),(7) VerpackDG, see the register’s catalogue)."
          },
          "beverage_carton": {
            "type": "boolean",
            "default": false,
            "description": "Composite beverage carton."
          },
          "reusable_in_system": {
            "type": "boolean",
            "default": false,
            "description": "Reusable packaging in an existing reuse system (§ 11 no. 1)."
          },
          "deposit_single_use_beverage": {
            "type": "boolean",
            "default": false,
            "description": "Single-use beverage packaging subject to the deposit (§ 11 no. 2, § 46)."
          },
          "hazardous_contents": {
            "type": "boolean",
            "default": false,
            "description": "Sales packaging of hazardous contents listed in Annex 1 (§ 11 no. 3)."
          },
          "not_supplied_in_germany": {
            "type": "boolean",
            "default": false,
            "description": "Demonstrably not delivered to end customers in Germany (§ 11 no. 4)."
          },
          "components": {
            "type": "array",
            "minItems": 1,
            "maxItems": 30,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "material",
                "grams"
              ],
              "properties": {
                "material": {
                  "type": "string",
                  "enum": [
                    "glass",
                    "paper_board",
                    "ferrous_metal",
                    "aluminium",
                    "plastic",
                    "wood",
                    "textile",
                    "ceramic",
                    "natural_material",
                    "other"
                  ],
                  "description": "Material of the component."
                },
                "grams": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000,
                  "description": "Mass per packaging unit in grams."
                },
                "bonded_group": {
                  "type": "string",
                  "maxLength": 40,
                  "description": "Components with the same value cannot be separated by hand (composite candidate); leave empty for separable parts."
                },
                "element": {
                  "type": "string",
                  "enum": [
                    "body",
                    "closure",
                    "label",
                    "varnish",
                    "paint",
                    "ink",
                    "adhesive",
                    "lacquer",
                    "other"
                  ],
                  "default": "body",
                  "description": "Function of the component (labels etc. are disregarded for the composite test from 2027)."
                }
              }
            }
          }
        }
      }
    },
    "previous_year_system_kg": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000000,
      "description": "Mass of system-participation packaging in the previous year, for the 10 t rule of § 9(2)."
    }
  }
}

Open original schema

Published input example

{
  "reporting_year": 2026,
  "items": [
    {
      "id": "jam-200",
      "units": 1000,
      "packaging_type": "sales",
      "typically_private_final_consumer": true,
      "components": [
        {
          "material": "glass",
          "grams": 200
        },
        {
          "material": "ferrous_metal",
          "grams": 10,
          "element": "closure"
        }
      ]
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →