LCA Tools

Query Life Cycle Assessment (LCA) data — product portfolios with environmental impact results broken down by EN 15804 life cycle stages. Each LCA represents a product-level assessment covering raw materials (A1), transport (A2), manufacturing (A3), distribution (A4), and operational use (B6/B7).

`list_lcas`

List all LCA portfolios for the organization with pagination. Parameters:

Parameter	Type	Required	Default	Description
`organization_id`	string	No	default org	Organization UUID
`page`	integer	No	1	Page number
`size`	integer	No	50	Results per page

Example response:

{
  "items": [
    {
      "id": "lca-1a2b3c4d-...",
      "organization_id": "a1b2c3d4-...",
      "name": "Ceramic Tile 60x60",
      "description": "Environmental assessment for standard ceramic floor tiles",
      "impact_categories": ["climate_change", "acidification", "ozone_depletion"],
      "unit_id": "m2",
      "value": 1.0,
      "start_date": "2024-01-01",
      "end_date": "2024-12-31",
      "status": "active",
      "created_at": "2024-03-15T10:00:00",
      "updated_at": "2025-01-20T14:30:00"
    }
  ],
  "total": 8,
  "page": 1,
  "size": 50
}

Key response fields:

Field	Description
`impact_categories`	Selected impact categories for this assessment (see list below)
`unit_id` / `value`	Functional unit (e.g. 1.0 m², 1.0 kg)
`start_date` / `end_date`	Assessment period
`status`	`active`, `draft`, or `archived`

`get_lca_dashboard`

Get calculated environmental impact results for an LCA, organized by EN 15804 life cycle stages. This is the main results view. Parameters:

Parameter	Type	Required	Default	Description
`lca_id`	string	Yes	—	UUID of the LCA portfolio
`organization_id`	string	No	default org	Organization UUID
`view`	string	No	`system`	Allocation view: `system`, `product_total`, or `product_unit`
`output_product_id`	string	No	—	Co-product UUID (required for `product_total` / `product_unit`)

Example response:

{
  "meta": {
    "lca_id": "lca-1a2b3c4d-...",
    "product_name": "Ceramic Tile 60x60",
    "methodology_id": "meth-5e6f7a8b-...",
    "functional_unit_value": 1.0,
    "functional_unit_id": "m2",
    "view": "system",
    "selected_output_product_id": null,
    "allocation_method": null,
    "output_products": []
  },
  "stages": [
    {
      "stage": "A1",
      "phase": "Production",
      "label": "Raw material supply",
      "categories": [
        {
          "impact_category": "climate_change",
          "impact_value": 8.45,
          "impact_unit": "kg CO2-Eq",
          "top_contributors": [
            { "block_id": "blk-1a2b3c4d-...", "block_name": "Clay extraction", "impact_value": 5.2 },
            { "block_id": "blk-5e6f7a8b-...", "block_name": "Feldspar mining", "impact_value": 3.25 }
          ]
        },
        {
          "impact_category": "acidification",
          "impact_value": 0.032,
          "impact_unit": "mol H+-Eq",
          "top_contributors": []
        }
      ]
    },
    {
      "stage": "A3",
      "phase": "Production",
      "label": "Manufacturing",
      "categories": [
        {
          "impact_category": "climate_change",
          "impact_value": 12.8,
          "impact_unit": "kg CO2-Eq",
          "top_contributors": [
            { "block_id": "blk-9c0d1e2f-...", "block_name": "Kiln firing", "impact_value": 11.5 }
          ]
        }
      ]
    }
  ],
  "is_stale": false,
  "validation_errors": [],
  "calculation_warnings": []
}

Key response fields:

Field	Description
`meta.view`	Active view: `system` (whole system), `product_total` (allocated to one co-product), `product_unit` (per-unit of co-product)
`meta.output_products`	Available co-products with allocation factors (for multi-product LCAs)
`stages[].stage`	EN 15804 code: A1, A2, A3, A4, B6, B7
`stages[].categories[].impact_value`	Calculated impact value for the category
`stages[].categories[].top_contributors`	Blocks contributing most to this impact
`is_stale`	Whether results need recalculation due to data changes
`validation_errors`	Structural issues preventing calculation (missing materials, invalid conversions)
`calculation_warnings`	Per-category warnings when a calculation fails silently

For LCAs with co-products (multiple output products), use view=product_total or view=product_unit with output_product_id to see allocated impacts. The meta.output_products array lists available co-products and their allocation factors.

`get_lca_block_impacts`

Get impact values broken down by lifecycle block (process stage) for a specific impact category. Useful for identifying which manufacturing step has the highest environmental impact. Parameters:

Parameter	Type	Required	Default	Description
`lca_id`	string	Yes	—	UUID of the LCA portfolio
`organization_id`	string	No	default org	Organization UUID
`impact_category`	string	No	—	Impact category filter (e.g. `climate_change`)

Example response:

{
  "items": [
    {
      "block_id": "blk-9c0d1e2f-...",
      "sum_total_impact": 11.5,
      "impact_general_unit_id": "climate_change",
      "impact_specific_unit": "kg CO2-Eq"
    },
    {
      "block_id": "blk-1a2b3c4d-...",
      "sum_total_impact": 5.2,
      "impact_general_unit_id": "climate_change",
      "impact_specific_unit": "kg CO2-Eq"
    }
  ]
}

`get_lca_piece_impacts`

Get impact values broken down by material/piece within the LCA. Useful for identifying which raw materials contribute most to environmental impact. Parameters:

Parameter	Type	Required	Default	Description
`lca_id`	string	Yes	—	UUID of the LCA portfolio
`organization_id`	string	No	default org	Organization UUID
`impact_category`	string	No	—	Impact category filter

Example response:

{
  "blocks": [
    {
      "block_id": "blk-1a2b3c4d-...",
      "pieces": [
        {
          "piece_id": "pce-5e6f7a8b-...",
          "piece_name": "Red clay",
          "impact_value": 3.8,
          "impact_unit": "kg CO2-Eq"
        },
        {
          "piece_id": "pce-9c0d1e2f-...",
          "piece_name": "Feldspar",
          "impact_value": 1.4,
          "impact_unit": "kg CO2-Eq"
        }
      ]
    }
  ]
}

`validate_lca`

Run validation checks on an LCA portfolio. Returns whether the LCA configuration is complete. Parameters:

Parameter	Type	Required	Default	Description
`lca_id`	string	Yes	—	UUID of the LCA portfolio
`organization_id`	string	No	default org	Organization UUID

For detailed validation information, prefer get_lca_dashboard — its validation_errors array provides structured error codes (no_materials, invalid_conversions, missing_transport_data, pending_distances) with affected pieces listed.

Life Cycle Stages (EN 15804)

Stage	Phase	Description
A1	Production	Raw material supply
A2	Production	Transport to manufacturer
A3	Production	Manufacturing
A4	Downstream	Distribution
B6	Downstream	Operational energy use
B7	Downstream	Operational water use

Impact categories (36)

Climate change indicators:

Category	Description
`climate_change`	Total climate change (kg CO2-Eq)
`climate_change_GHG`	Climate change — greenhouse gases
`climate_change_fossil`	Climate change — fossil sources
`climate_change_biogenic`	Climate change — biogenic sources
`climate_change_land_use`	Climate change — land use

Environmental indicators:

Category	Description
`acidification`	Acidification (mol H+-Eq)
`ozone_depletion`	Ozone layer depletion
`eutrophication_freshwater`	Freshwater eutrophication
`eutrophication_marine`	Marine eutrophication
`eutrophication_terrestrial`	Terrestrial eutrophication
`photochemical_oxidant_formation_human`	Photochemical ozone formation
`particulate_matter_formation`	Particulate matter
`human_toxicity_carcinogenic`	Human toxicity — carcinogenic
`human_toxicity_non_carcinogenic`	Human toxicity — non-carcinogenic
`ecotoxicity_freshwater`	Freshwater ecotoxicity
`ionising_radiation`	Ionising radiation
`land_use`	Land use
`water_scarcity`	Water scarcity

Resource use indicators:

Category	Description
`fossil_fuels_depletion`	Fossil fuel depletion
`material_resources_depletion`	Mineral and metal depletion
`renewable_energy_resources`	Renewable primary energy use
`non_renewable_energy_resources`	Non-renewable primary energy use
`use_net_fresh_water`	Net fresh water use
`use_secondary_material`	Use of secondary material
`use_renewable_secondary_fuels`	Use of renewable secondary fuels
`use_non_renewable_secondary_fuels`	Use of non-renewable secondary fuels

Waste indicators:

Category	Description
`hazardous_waste`	Hazardous waste disposed
`non_hazardous_waste`	Non-hazardous waste disposed
`high_level_radioactive_waste`	High-level radioactive waste
`int_low_level_radioactive_waste`	Intermediate/low-level radioactive waste

Output flow indicators:

Category	Description
`components_re_use`	Components for re-use
`materials_recycling`	Materials for recycling
`materials_energy_recovery`	Materials for energy recovery
`exported_energy_electricity`	Exported energy — electricity
`exported_energy_heat`	Exported energy — heat
`recovered_energy`	Recovered energy

Example prompts:

"List my LCA portfolios"
"What are the climate change impacts for my ceramic tile LCA?"
"Compare A1 vs A3 stage impacts — where does the most CO2 come from?"
"Show per-unit environmental impacts for product xyz in LCA abc-123"
"Which materials have the highest climate change impact?"
"Is my LCA complete and valid?"
"What's the total acidification impact across all stages?"

Workflow

Discover LCAs — list_lcas to see available portfolios and their status
View results — get_lca_dashboard for the full impact breakdown by EN 15804 stage
Drill into blocks — get_lca_block_impacts with impact_category=climate_change to see which process step dominates
Drill into materials — get_lca_piece_impacts to identify which raw materials drive the most impact
Check validity — validate_lca or check validation_errors in the dashboard response
Co-product analysis — For multi-product LCAs, use view=product_unit with output_product_id for per-unit impacts

Emissions

Organization-level GHG emissions (complementary to product-level LCA)

Projects

Projects that LCA portfolios are organized under

Facilities

Manufacturing sites where LCA products are produced

API Reference

REST API endpoints for Life Cycle Assessment

Getting Started

Tools Reference

Reference Data

LCA Tools

LCA Tools

`list_lcas`

`get_lca_dashboard`

`get_lca_block_impacts`

`get_lca_piece_impacts`

`validate_lca`

Life Cycle Stages (EN 15804)

Workflow

Emissions

Projects

Facilities

API Reference

​LCA Tools

​list_lcas

​get_lca_dashboard

​get_lca_block_impacts

​get_lca_piece_impacts

​validate_lca

​Life Cycle Stages (EN 15804)

​Workflow

​Related

Emissions

Projects

Facilities

API Reference

LCA Tools

`list_lcas`

`get_lca_dashboard`

`get_lca_block_impacts`

`get_lca_piece_impacts`

`validate_lca`

Life Cycle Stages (EN 15804)

Workflow

Related