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": "Materials and components",
      "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`	What contributes most to this impact: pieces in A1–A3; the destination country (A4), consumption type (B6/B7) or treated material (C4) downstream
`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.

Building an LCA from your data

Your AI assistant can create an LCA for you from a bill of materials, a data-gathering spreadsheet or data you give it in the chat. It covers your product from its raw materials to your factory door: raw materials (A1), transport from your suppliers (A2, optional) and manufacturing (A3). It can then carry on past the factory door with distribution, use and end of life (see Distribution, use and end of life). How it works:

The assistant reads your file (or asks you for the data, bit by bit) and shows you what it understood.
You agree the plan together: how materials are grouped, which materials already exist in your catalog and which are new, whether Leia maps the new ones to emission factors, what the factory consumes and whether to include transport.
You approve the plan once, and the assistant creates the materials and the LCA.
You review the result in the Dcycle app: Leia’s matches, the transport estimate and any change you want.

The assistant follows the method returned by get_lca_build_guide (also available as the build_lca_from_file prompt). Write tools create real records in your organization and act with your user’s permissions.

Tool	What it does	Key parameters
`get_lca_build_guide`	The method: how to read the data, what to agree with you, the creation order	—
`list_lca_materials`	Your LCA resources with their ecoinvent activity, location, unit conversions and Leia status	`search`, `material_type`
`search_ecoinvent_activities`	Search ecoinvent 3.11 activities by name	`search`
`get_ecoinvent_activity_locations`	Locations of an activity, and the one suggested for a country	`activity`, `country`
`create_lca_material`	Create a resource with an explicit factor, or let Leia map it in the background	`name`, `supplier`, `supplier_country`, `material_type`, `ecoinvent_activity` + `ecoinvent_location` or `leia_match_mode` (`full_auto`, `auto`, `manual`)
`link_lca_material`	Give an existing resource an ecoinvent factor	`material_id`, `activity`, `location`
`update_lca_material_location`	Set a supplier address (used to estimate transport distances)	`material_id`, `address`, `postal_code`
`add_lca_material_unit`	Add a unit conversion (e.g. 1 kWh = 3.6 MJ), keeping the existing ones	`material_id`, `unit_id`, `value`
`create_lca`	Create an empty LCA; returns `lca_id` and `process_block_id`	`name`, `start_date`, `end_date` (YYYY-MM-DD), `functional_unit_id`
`add_lca_material_block`	Add a group of materials feeding the manufacturing process	`lca_id`, `process_block_id`, `block_name`, `materials`
`set_lca_process_inputs`	Set what the factory consumes per unit (energy, water, consumables, waste)	`lca_id`, `process_block_id`, `inputs`, `country`, `address`
`add_lca_transport_block`	Add transport from suppliers; distances are estimated in the background	`lca_id`, `process_block_id`, `origin_block_ids`
`get_lca_transport`	Per material: transport legs, the Dcycle estimate and your changes	`lca_id`, `transport_block_id`
`set_lca_transport_legs`	Set known transport modes and distances for a material	`material_id`, `legs` (`toc`, `distance_km`), `scope`
`get_lca_calculation_errors`	What does not compute yet (missing factor, unit conversion, transport pending)	`lca_id`
`delete_lca`	Delete an LCA; your catalog resources are kept	`lca_id`
`list_lca_blocks`	The blocks of an LCA with their ids, types and connections, to edit an LCA made elsewhere	`lca_id`
`delete_lca_block`	Delete a block and its connections; distribution, use and end of life go right to left	`lca_id`, `node_id`

Distribution, use and end of life

Once the product leaves the factory, the assistant can add the rest of its life: where it is sold (A4), what it consumes while in use (B6/B7) and how it is treated at the end (C4). The blocks go in this order, each one after the previous: final product → distribution → use → end of life. Use is optional: end of life can follow the distribution directly. Distribution (A4). You give the countries the product is sold to and how many units go to each, plus an address or postal code when you have it. Dcycle estimates each route (km and transport mode) from the factory, so the factory needs its country first (set_lca_process_inputs). The assistant waits for the destinations to be imported: if Dcycle rejects them, it tells you why and removes the empty block. Routes are estimated in the background, so review them: the assistant shows them to you, and any route you know better (e.g. by lorry, not by ship) can be typed by hand. Use (B6/B7). Lifespan of one product and what it consumes over it: electricity (kWh), water (kg) and fuel (MJ of petrol, diesel or natural gas), each as a total over its life or per year, month, week or day. End of life (C4). Dcycle creates one entry per destination country with a default treatment mix for that country. You can set your own split between recycling, incineration, landfill and composting, for the whole product or material by material.

Tool	What it does	Key parameters
`add_lca_distribution_block`	Add the distribution after the final product, with its destinations	`lca_id`, `product_block_id`, `name`, `destinations` (`country`, `units_sold`, address, postal code), `weight_type` (`product` or `material`), `product_weight` (kg per unit)
`get_lca_distribution`	Each destination with its route: km, transport mode and whether Dcycle estimated it or you typed it	`distribution_block_id`
`update_lca_distribution`	Change units, addresses, weight or routes; a typed route is kept over Dcycle’s estimate	`distribution_block_id`, `destinations` (`distribution_id`, `km`, `transport_mode`…)
`reestimate_lca_distribution_route`	Have Dcycle estimate one route again (a failed estimate, or to drop a typed route)	`distribution_block_id`, `distribution_id`
`add_lca_product_use_block`	Add the use phase after a distribution	`lca_id`, `distribution_block_id`, `name`, `lifespan`, `electricity`, `water`, `combustion`
`get_lca_product_use`	Lifespan and consumptions per product	`product_use_block_id`
`set_lca_product_use`	Change the lifespan or consumptions, or remove one	`product_use_block_id`, `lifespan`, `electricity`, `water`, `combustion`, `remove`
`add_lca_end_of_life_block`	Add end of life after the use phase (or the distribution)	`lca_id`, `origin_block_id`, `mode` (`product` or `material`)
`get_lca_end_of_life`	Each entry (waste × country) with its treatment split	`end_of_life_block_id`
`set_lca_end_of_life_treatments`	Set the treatment split of some entries, or switch mode	`end_of_life_block_id`, `entries` (`entry_id`, `treatments`), `mode`
`get_lca_end_of_life_breakdown`	End-of-life impact per country, material and treatment	`end_of_life_block_id`, `impact_category`

Write tools change real data: the assistant confirms with you before changing a distribution, a use phase or end-of-life treatments, or deleting a block.

Scenario modelling

Ask “what if?” about an existing LCA without touching it: the assistant copies it into a draft scenario, makes your changes there grouped in named design changes (“Recycled PET”, “Local sourcing”…), and tells you how much each one changes every impact category. A scenario only changes values (quantities, units, a material swapped for another, transport legs, distribution, use phase): adding or removing blocks or rows is refused. Scenario modelling has to be enabled for your organization. The edits themselves use the usual edit tools on the scenario’s id (update_lca_material_quantity, replace_lca_block_material, set_lca_process_inputs, set_lca_transport_legs, update_lca_distribution, set_lca_product_use); each one is logged under the active design change.

Tool	What it does	Key parameters
`create_lca_scenario` / `list_lca_scenarios`	Copy an LCA into a draft scenario, or list a baseline’s scenarios	`lca_id`, `name`
`get_lca_scenario`	The scenario’s design changes and their logged edits, and whether its comparison is out of date	`scenario_id`
`add_lca_design_change`	Add a named design change; the next edits go under it	`scenario_id`, `name`
`update_lca_design_change` / `delete_lca_design_change`	Rename or activate a design change, or delete an empty one	`scenario_id`, `design_change_id`, `name`, `activate`
`replace_lca_block_material`	Swap one material of a block for another resource, keeping its quantity and unit	`lca_id`, `node_id`, `relation_id`, `new_material_id`
`update_lca_scenario_edit` / `undo_lca_scenario_edit`	Change a logged edit’s value, or undo it	`scenario_id`, `edit_id`, `value`
`compare_lca_scenario`	Calculate the difference with the baseline per impact category, split per design change	`scenario_id`, `impact_categories`
`get_lca_scenario_comparison`	The last comparison, without recalculating	`scenario_id`, `impact_categories`
`save_lca_scenario` / `discard_lca_scenario`	Keep the scenario as an LCA linked to its baseline, or delete the draft	`scenario_id`, `name`, `description`

"Make a scenario of the Granit lamp: replace the steel housing with recycled aluminium and halve the driver's
power, then tell me how much each change saves in climate change"

The same workflow is available over the REST API: LCA Scenarios.

Life Cycle Stages (EN 15804)

Stage	Phase	Description
A1	Production	Materials and components
A2	Production	Transport
A3	Production	Manufacturing
A4	Downstream	Distribution
B6	Downstream	Operational energy use
B7	Downstream	Operational water use
C4	Downstream	Disposal

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?"
"Add distribution to my lamp LCA: 1,200 units to France and 800 to Portugal, 2.3 kg each"
"The route to Madrid goes by lorry, about 1,100 km"
"Each lamp uses 12 kWh a year for 5 years"
"At end of life, 60% is recycled and 40% goes to landfill"

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
Past the factory door — add_lca_distribution_block, review routes with get_lca_distribution, then add_lca_product_use_block and add_lca_end_of_life_block
Ecodesign — create_lca_scenario → add_lca_design_change → edit the scenario → compare_lca_scenario

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

`list_lcas`

`get_lca_dashboard`

`get_lca_block_impacts`

`get_lca_piece_impacts`

`validate_lca`

Building an LCA from your data

Distribution, use and end of life

Scenario modelling

Life Cycle Stages (EN 15804)

Workflow

Emissions

Projects

Facilities

API Reference

​list_lcas

​get_lca_dashboard

​get_lca_block_impacts

​get_lca_piece_impacts

​validate_lca

​Building an LCA from your data

​Distribution, use and end of life

​Scenario modelling

​Life Cycle Stages (EN 15804)

​Workflow

​Related

Emissions

Projects

Facilities

API Reference

`list_lcas`

`get_lca_dashboard`

`get_lca_block_impacts`

`get_lca_piece_impacts`

`validate_lca`

Building an LCA from your data

Distribution, use and end of life

Scenario modelling

Life Cycle Stages (EN 15804)

Workflow

Related