Skip to main content

​
Life Cycle Assessment (LCA) API

The LCA API allows you to list your organization’s Life Cycle Assessment portfolios and retrieve their calculated environmental impact results, broken down by EN 15804 life cycle stages.
Read-only API: These endpoints provide read access to LCA data. To create LCAs programmatically, use the POST /lca/create-from-json or POST /lca/create-from-excel endpoints.

​
Key Concepts

​
Life Cycle Stages (EN 15804)

LCA results are organized by EN 15804 life cycle stages:
StagePhaseDescription
A1ProductionRaw material supply
A2ProductionTransport to manufacturer
A3ProductionManufacturing
A4DownstreamDistribution
B6DownstreamOperational energy use
B7DownstreamOperational water use

​
Impact Categories

Each stage contains results for multiple environmental impact categories, including:
  • climate_change — Total climate change impact (kg CO2-Eq)
  • climate_change_GHG — Climate change from greenhouse gases
  • climate_change_fossil — Climate change from fossil sources
  • climate_change_biogenic — Climate change from biogenic sources
  • acidification — Acidification potential
  • eutrophication_freshwater — Freshwater eutrophication
  • eutrophication_marine — Marine eutrophication
  • ozone_depletion — Ozone depletion potential
  • water_scarcity — Water scarcity footprint
  • land_use — Land use impact
  • human_toxicity_carcinogenic — Human toxicity (carcinogenic)
  • human_toxicity_non_carcinogenic — Human toxicity (non-carcinogenic)
And more (31 categories total following EN 15804+A2).

​
Co-Product Allocation

LCAs with multiple output products (co-products) support different allocation views:
  • system (default): Total system impact, no allocation applied
  • product_total: Impact allocated to a specific co-product (system impact x allocation factor)
  • product_unit: Per-unit impact of a co-product (system impact x allocation factor / quantity)

​
Authentication

All endpoints require authentication using either:
  • API Key: Include in x-api-key header
  • JWT Token: Include in Authorization header as Bearer {JWT_TOKEN}

​
Headers

All requests must include:
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
​
x-api-key
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef

​
Available Endpoints

List LCA Portfolios

Retrieve all LCA portfolios with pagination

Get LCA Dashboard

Get environmental impact results by life cycle stage

​
Error Handling

​
Common HTTP Status Codes

StatusMeaningSolution
200Success-
401UnauthorizedVerify API key or JWT token
403ForbiddenAPI key owner is not a member of the organization
404Not FoundCheck LCA ID or organization
422Validation ErrorReview error details in response

Authentication Guide

Learn how to get your API key and authenticate requests

LCA Guide

Learn about Life Cycle Assessment concepts and impact categories