Skip to main content
GET
/
v1
/
lca
/
impacts
/
{lca_id}
Get LCA Impacts
const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/lca/impacts/{lca_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "items": [
    {
      "block_id": "<string>",
      "sum_total_impact": 123,
      "impact_general_unit_id": "<string>",
      "impact_specific_unit": {}
    }
  ]
}

​
Get LCA Impacts

Calculates and returns environmental impacts for an LCA portfolio using a specified methodology and impact category. Returns impact values per process block.
Use Validate LCA first to ensure all required data is in place before requesting impact calculations.

​
Request

​
Headers

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

​
Path Parameters

​
lca_id
string
required
UUID of the LCA portfolioExample: 550e8400-e29b-41d4-a716-446655440000

​
Query Parameters

​
methodology_id
string
required
UUID of the methodology to use for impact calculationExample: d4e5f6a7-b8c9-0123-def4-567890123456
​
impact_category
string
required
Impact category identifierCommon values: gwp, ap, ep, pocp, adp
​
process_id_list
string
required
JSON string containing a list of process block UUIDs to include in the calculationExample: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890","b2c3d4e5-f6a7-8901-bcde-f12345678901"]

​
Response

​
items
array
List of impact results per process block

​
Example

curl -X GET "https://api.dcycle.io/v1/lca/impacts/${LCA_ID}?methodology_id=${METHODOLOGY_ID}&impact_category=gwp&process_id_list=%5B%22${PROCESS_ID_1}%22%2C%22${PROCESS_ID_2}%22%5D" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

​
Successful Response

{
  "items": [
    {
      "block_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sum_total_impact": 12.345,
      "impact_general_unit_id": "kg CO2 eq",
      "impact_specific_unit": null
    },
    {
      "block_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "sum_total_impact": 3.678,
      "impact_general_unit_id": "kg CO2 eq",
      "impact_specific_unit": null
    }
  ]
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

​
403 Forbidden

Cause: The authenticated user is not a member of the organization 
{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}

​
404 Not Found

Cause: LCA portfolio not found or doesn’t belong to your organization 
{"detail": "LCA Portfolio not found"}

​
422 Unprocessable Entity

Cause: Missing required query parameters or invalid JSON in process_id_list 
{
  "detail": [
    {
      "loc": ["query", "process_id_list"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

Validate LCA

Validate before calculating impacts

Export to Excel

Export impact results as spreadsheet

LCA Dashboard

View aggregated environmental impact results