PPWR Tools

Query PPWR (Packaging and Packaging Waste Regulation) compliance data — packaging units, bill of materials, substance declarations, recyclability, gap analysis, and compliance evaluations. These tools support EU packaging regulation workflows.

PPWR tools cover the packaging compliance pillar. All endpoints use API v2 (/v2/ppwr/). Use list_projects first to find the project ID containing your packaging data.

`list_packaging_units`

List packaging units for a PPWR project. Each unit represents a distinct packaging product being assessed for compliance. Parameters:

Parameter	Type	Required	Default	Description
`project_id`	string	Yes	—	Project UUID
`organization_id`	string	No	default org	Organization UUID

Example response:

[
  {
    "id": "a1b2c3d4-...",
    "name": "Premium Wine Box",
    "packaging_type": "primary",
    "weight_grams": 450.0,
    "volume_ml": 750.0,
    "status": "in_progress",
    "target_markets": ["ES", "FR", "DE"],
    "is_food_contact": true,
    "ean_code": "8412345678901",
    "project_id": "proj-uuid-...",
    "organization_id": "org-uuid-..."
  }
]

Key response fields:

Field	Description
`packaging_type`	Type: `primary`, `secondary`, `tertiary`, or `transport`
`weight_grams`	Total packaging weight in grams
`status`	Assessment status: `draft`, `in_progress`, `compliant`, `non_compliant`
`target_markets`	ISO 3166-1 alpha-2 country codes for target markets
`is_food_contact`	Whether packaging is intended for food contact (Reg. EC 1935/2004)

Example prompts:

"List all packaging units in this project"
"Which packaging units target the French market?"
"Show packaging units that are still in draft status"

`get_packaging_unit`

Get full detail for a packaging unit — including bill of materials (BOM), substance declarations, and recyclability assessment. Parameters:

Parameter	Type	Required	Default	Description
`packaging_unit_id`	string	Yes	—	Packaging unit UUID

Example response:

{
  "id": "a1b2c3d4-...",
  "name": "Premium Wine Box",
  "packaging_type": "primary",
  "weight_grams": 450.0,
  "volume_ml": 750.0,
  "status": "in_progress",
  "target_markets": ["ES", "FR", "DE"],
  "is_food_contact": true,
  "bom_items": [
    {
      "id": "b2c3d4e5-...",
      "component_name": "Outer carton",
      "material_type": "paper_cardboard",
      "weight_grams": 320.0,
      "recycled_percentage": 85.0
    }
  ],
  "substances": [
    {
      "id": "c3d4e5f6-...",
      "substance_name": "lead",
      "concentration_ppm": 5.0,
      "compliant": true
    }
  ],
  "recyclability": {
    "grade": "B",
    "assessed_by": "user-uuid-..."
  }
}

Example prompts:

"Show the full detail for packaging unit X"
"What materials are in this packaging unit's BOM?"
"What substances have been declared?"

`get_packaging_compliance`

Evaluate PPWR compliance for a single packaging unit. Returns pass/fail checks against specific PPWR articles, a timeline of upcoming deadlines, and overall compliance status. Parameters:

Parameter	Type	Required	Default	Description
`packaging_unit_id`	string	Yes	—	Packaging unit UUID

Example response:

{
  "packaging_unit_id": "a1b2c3d4-...",
  "packaging_unit_name": "Premium Wine Box",
  "overall_status": "partial",
  "checks": [
    {
      "code": "RECYCLED_CONTENT_MIN",
      "requirement": "Minimum recycled content percentage",
      "article": "Art. 7(1)",
      "status": "pass",
      "current_value": "85%",
      "threshold": "65%",
      "deadline": "2030-01-01"
    },
    {
      "code": "HEAVY_METALS_LIMIT",
      "requirement": "Sum of lead, cadmium, mercury, chromium VI below 100 ppm",
      "article": "Art. 5(1)",
      "status": "fail",
      "current_value": "120 ppm",
      "threshold": "100 ppm"
    }
  ],
  "timeline": [
    {
      "deadline": "2030-01-01",
      "requirement": "Recycled content targets for paper packaging",
      "status": "on_track",
      "action": "Maintain current recycled content above 65%"
    }
  ],
  "compliant_count": 4,
  "failed_count": 1,
  "insufficient_count": 1
}

Key response fields:

Field	Description
`overall_status`	`compliant`, `non_compliant`, `partial`, or `insufficient_data`
`checks[].status`	Per-check result: `pass`, `fail`, or `insufficient_data`
`checks[].article`	PPWR article reference (e.g. “Art. 5(1)“)
`timeline[].status`	Deadline tracking: `on_track`, `at_risk`, or `non_compliant`

Example prompts:

"Is this packaging unit PPWR compliant?"
"Which compliance checks are failing?"
"What are the upcoming PPWR deadlines for this unit?"

`get_project_compliance`

Evaluate PPWR compliance for all packaging units in a project. Returns a project-level summary with per-unit evaluations. Parameters:

Parameter	Type	Required	Default	Description
`project_id`	string	Yes	—	Project UUID
`organization_id`	string	No	default org	Organization UUID

Example response:

{
  "project_id": "proj-uuid-...",
  "total_units": 8,
  "compliant_units": 5,
  "non_compliant_units": 1,
  "partial_units": 1,
  "insufficient_data_units": 1,
  "unit_evaluations": [
    {
      "packaging_unit_id": "a1b2c3d4-...",
      "packaging_unit_name": "Premium Wine Box",
      "overall_status": "compliant",
      "compliant_count": 6,
      "failed_count": 0,
      "insufficient_count": 0
    }
  ]
}

Example prompts:

"How many packaging units are PPWR compliant?"
"Show the compliance status of all units in this project"
"Which units are non-compliant?"

`get_packaging_gaps`

Analyze compliance gaps for a packaging unit using a traffic-light severity system. Each gap identifies a specific PPWR requirement that is not met, with the affected BOM components and required actions. Parameters:

Parameter	Type	Required	Default	Description
`packaging_unit_id`	string	Yes	—	Packaging unit UUID

Example response:

{
  "packaging_unit_id": "a1b2c3d4-...",
  "packaging_unit_name": "Premium Wine Box",
  "overall_risk": "yellow",
  "gaps": [
    {
      "code": "PFAS_NO_DECLARATION",
      "severity": "red",
      "category": "substances",
      "article": "Art. 5(4)",
      "description": "No PFAS declaration for food-contact packaging",
      "deadline": "2026-12-31",
      "action_required": "Obtain PFAS test certificate from supplier",
      "affected_components": ["Inner liner"]
    },
    {
      "code": "RECYCLED_CONTENT_MISSING",
      "severity": "yellow",
      "category": "recycled_content",
      "article": "Art. 7(1)",
      "description": "Recycled content not declared for 2 BOM items",
      "action_required": "Request recycled content data from suppliers",
      "affected_components": ["Outer carton", "Closure"]
    }
  ],
  "total_red": 1,
  "total_yellow": 1,
  "total_green": 0
}

Key response fields:

Field	Description
`overall_risk`	Worst-case severity across all gaps: `red` > `yellow` > `green`
`gaps[].severity`	Traffic-light risk: `red` (blocking), `yellow` (at risk), `green` (minor)
`gaps[].category`	Gap area: `substances`, `recycled_content`, `recyclability`, `material`, `labeling`
`gaps[].affected_components`	BOM item names affected by this gap

Example prompts:

"What compliance gaps does this packaging unit have?"
"Are there any red-severity gaps?"
"What actions are required to close the gaps?"

`get_ppwr_dashboard`

Get PPWR compliance dashboard metrics for a project — a high-level overview of packaging compliance health including substance safety, recycled content, recyclability grades, and supplier survey progress. Parameters:

Parameter	Type	Required	Default	Description
`project_id`	string	Yes	—	Project UUID
`organization_id`	string	No	default org	Organization UUID

Example response:

{
  "total_units": 12,
  "avg_recycled_content": 72.5,
  "substances_total": 24,
  "substances_compliant": 20,
  "units_by_status": {
    "draft": 2,
    "in_progress": 3,
    "compliant": 5,
    "non_compliant": 2
  },
  "grade_distribution": {
    "A": 3,
    "B": 4,
    "C": 3,
    "D": 2
  },
  "supplier_progress": {
    "invited": 8,
    "submitted": 5,
    "validated": 3
  }
}

Key response fields:

Field	Description
`avg_recycled_content`	Average recycled content percentage across all units
`substances_compliant`	Count of substance declarations that pass limits
`units_by_status`	Count of units by assessment status
`grade_distribution`	Count of units by recyclability grade (A–E)
`supplier_progress`	Supplier data collection funnel

Example prompts:

"Show the PPWR dashboard for this project"
"What's the average recycled content across our packaging?"
"How many supplier surveys have been validated?"

Workflow

Find your project — list_projects to find the project containing packaging data
List packaging units — list_packaging_units to see all units in the project
Check dashboard — get_ppwr_dashboard for a high-level compliance overview
Dive into a unit — get_packaging_unit for full detail (BOM, substances, recyclability)
Check compliance — get_packaging_compliance for pass/fail checks and deadlines
Identify gaps — get_packaging_gaps for traffic-light gap analysis with required actions
Project-wide view — get_project_compliance for a summary across all units

Projects

Find project IDs containing packaging data

CSRD

CSRD/ESRS compliance and double materiality

Emissions

GHG emissions for environmental impact

Organizations

Organization hierarchy for group-level views

​PPWR Tools

​list_packaging_units

​get_packaging_unit

​get_packaging_compliance

​get_project_compliance

​get_packaging_gaps

​get_ppwr_dashboard

​Workflow

​Related

Projects

CSRD

Emissions

Organizations

PPWR Tools

`list_packaging_units`

`get_packaging_unit`

`get_packaging_compliance`

`get_project_compliance`

`get_packaging_gaps`

`get_ppwr_dashboard`

Workflow

Related