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/lca/impacts/{lca_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/lca/impacts/{lca_id}"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/lca/impacts/{lca_id} \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"items": [
{
"block_id": "<string>",
"sum_total_impact": 123,
"impact_general_unit_id": "<string>",
"impact_specific_unit": {}
}
]
}Get LCA Impacts
Calculate and retrieve environmental impacts for an LCA portfolio
GET
/
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/lca/impacts/{lca_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/lca/impacts/{lca_id}"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/lca/impacts/{lca_id} \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"items": [
{
"block_id": "<string>",
"sum_total_impact": 123,
"impact_general_unit_id": "<string>",
"impact_specific_unit": {}
}
]
}← LCA API
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
string
required
Your API key for authenticationExample:
sk_live_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faPath Parameters
string
required
UUID of the LCA portfolioExample:
550e8400-e29b-41d4-a716-446655440000Query Parameters
string
required
UUID of the methodology to use for impact calculationExample:
d4e5f6a7-b8c9-0123-def4-567890123456string
required
Impact category identifierCommon values:
gwp, ap, ep, pocp, adpstring
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
array
Example
curl -X GET "https://api.dcycle.io/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}"
import json
import requests
import os
lca_id = "550e8400-e29b-41d4-a716-446655440000"
process_ids = [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901",
]
response = requests.get(
f"https://api.dcycle.io/lca/impacts/{lca_id}",
headers={
"x-api-key": os.getenv("DCYCLE_API_KEY"),
"x-organization-id": os.getenv("DCYCLE_ORG_ID"),
},
params={
"methodology_id": "d4e5f6a7-b8c9-0123-def4-567890123456",
"impact_category": "gwp",
"process_id_list": json.dumps(process_ids),
},
)
impacts = response.json()
for item in impacts["items"]:
print(f"Block {item['block_id']}: {item['sum_total_impact']} {item['impact_general_unit_id']}")
const axios = require('axios');
const lcaId = '550e8400-e29b-41d4-a716-446655440000';
const processIds = [
'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
'b2c3d4e5-f6a7-8901-bcde-f12345678901',
];
axios.get(`https://api.dcycle.io/lca/impacts/${lcaId}`, {
headers: {
'x-api-key': process.env.DCYCLE_API_KEY,
'x-organization-id': process.env.DCYCLE_ORG_ID,
},
params: {
methodology_id: 'd4e5f6a7-b8c9-0123-def4-567890123456',
impact_category: 'gwp',
process_id_list: JSON.stringify(processIds),
},
})
.then(({ data }) => {
data.items.forEach(item => {
console.log(`Block ${item.block_id}: ${item.sum_total_impact} ${item.impact_general_unit_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 inprocess_id_list
{
"detail": [
{
"loc": ["query", "process_id_list"],
"msg": "field required",
"type": "value_error.missing"
}
]
}
Related Endpoints
Validate LCA
Validate before calculating impacts
Export to Excel
Export impact results as spreadsheet
LCA routes are not versioned. Only portfolio creation is served under
/v1
(POST /v1/lca/portfolio); every other route in this module lives at /lca/....LCA Dashboard
View aggregated environmental impact results
Was this page helpful?