> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# LCA API

> Retrieve Life Cycle Assessment (LCA) portfolios and environmental impact results

# 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.

<Note>
  **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.
</Note>

## Key Concepts

### Life Cycle Stages (EN 15804)

LCA results are organized by EN 15804 life cycle stages:

| 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

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:

<ParamField header="x-organization-id" type="string" required>
  Your organization UUID

  **Example:** `a8315ef3-dd50-43f8-b7ce-d839e68d51fa`
</ParamField>

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication

  **Example:** `sk_live_1234567890abcdef`
</ParamField>

## Available Endpoints

<CardGroup cols={2}>
  <Card title="List LCA Portfolios" icon="list" href="/api-reference/lca/list">
    Retrieve all LCA portfolios with pagination
  </Card>

  <Card title="Get LCA Dashboard" icon="chart-bar" href="/api-reference/lca/dashboard">
    Get environmental impact results by life cycle stage
  </Card>
</CardGroup>

## Error Handling

### Common HTTP Status Codes

| Status | Meaning          | Solution                                          |
| ------ | ---------------- | ------------------------------------------------- |
| 200    | Success          | -                                                 |
| 401    | Unauthorized     | Verify API key or JWT token                       |
| 403    | Forbidden        | API key owner is not a member of the organization |
| 404    | Not Found        | Check LCA ID or organization                      |
| 422    | Validation Error | Review error details in response                  |

## Related Documentation

<CardGroup cols={2}>
  <Card title="Authentication Guide" icon="key" href="/docs/authentication">
    Learn how to get your API key and authenticate requests
  </Card>

  <Card title="LCA Guide" icon="leaf" href="/guides/lca/overview">
    Learn about Life Cycle Assessment concepts and impact categories
  </Card>
</CardGroup>