Filter Product EPD Impact Indicators
This task shows you how to retrieve and filter environmental impact indicators for a specific product EPD. Impact indicators provide detailed lifecycle assessment (LCA) data across different lifecycle stages, helping you understand the environmental footprint of building materials and products.
By the end of this task, you will know how to:
- Call the impact indicators filter endpoint for a specific EPD
- Understand different impact indicator types (GWP, ADPE, AP, etc.)
- Interpret lifecycle stage data (A1-A3, A4-A5, B1-B5, C1-C4, D)
- Work with reference periods for use-stage impacts
- Compare environmental impacts across different indicators
You use the following operation for this task:
| Operation | HTTP Request |
|---|---|
| Filter Impact Indicators for Product EPD | POST /v3/datasets/{datasetId}/product-epds/details/{productEpdId}/impacts:filter |
Prerequisites
Before starting this task, ensure you have:
- The access token from Obtain an Access Token (it should start with something like
eyJhbGciOiJIUzI1NiIs...) - Completed Get the List of Supported Datasets and obtained a dataset ID
- Completed Filter Product EPDs and obtained a product EPD ID from the product EPDs list
Step 1: Call the Impact Indicators Filter Endpoint
Use the access token from Obtain an Access Token, a dataset ID from Get the List of Supported Datasets, and a product EPD ID from Filter Product EPDs to retrieve impact indicators for a specific product EPD.
Replace <YOUR_ACCESS_TOKEN>, <DATASET_ID>, and <PRODUCT_EPD_ID> with your values.
curl -v 'https://developer.api.autodesk.com/sustainability/v3/datasets/<DATASET_ID>/product-epds/details/<PRODUCT_EPD_ID>/impacts:filter' \
-X 'POST' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"filters": {}
}'
const accessToken = "<YOUR_ACCESS_TOKEN>";
const datasetId = "<DATASET_ID>";
const productEpdId = "<PRODUCT_EPD_ID>";
const url = `https://developer.api.autodesk.com/sustainability/v3/datasets/${datasetId}/product-epds/details/${productEpdId}/impacts:filter`;
fetch(url, {
method: 'POST',
headers: {
'Authorization': `Bearer ${accessToken}`,
'Content-Type': 'application/json',
'Accept': 'application/json'
},
body: JSON.stringify({ filters: {} })
})
.then(response => response.json())
.then(data => {
const impacts = data.results;
console.log(`=== Impact Indicators (${impacts.length} indicators found) ===\n`);
impacts.forEach((impact, index) => {
console.log(`\n--- Indicator ${index + 1}: ${impact.indicator.toUpperCase()} ---`);
console.log(`Methodology: ${impact.methodology}`);
if (impact.declaredUnit) {
console.log(`Declared Unit: ${impact.declaredUnit.qty} ${impact.declaredUnit.unit}`);
}
// Display lifecycle stages with values
const stages = [
{ name: 'A1-A3 (Raw Materials & Manufacturing)', key: 'a1a2a3' },
{ name: 'A4 (Transport)', key: 'a4' },
{ name: 'A5 (Installation)', key: 'a5' },
{ name: 'B1 (Use)', key: 'b1' },
{ name: 'B2 (Maintenance)', key: 'b2' },
{ name: 'B3 (Repair)', key: 'b3' },
{ name: 'B4 (Replacement)', key: 'b4' },
{ name: 'B5 (Refurbishment)', key: 'b5' },
{ name: 'C1 (Deconstruction)', key: 'c1' },
{ name: 'C2 (Transport to Disposal)', key: 'c2' },
{ name: 'C3 (Waste Processing)', key: 'c3' },
{ name: 'C4 (Disposal)', key: 'c4' },
{ name: 'D (Beyond System Boundary)', key: 'd' }
];
console.log('\nLifecycle Stages:');
stages.forEach(stage => {
const stageData = impact[stage.key];
if (stageData && stageData.qty !== null && stageData.unit !== null) {
let output = ` ${stage.name}: ${stageData.qty} ${stageData.unit}`;
if (stageData.referencePeriod) {
output += ` (over ${stageData.referencePeriod.qty} ${stageData.referencePeriod.unit})`;
}
console.log(output);
}
});
});
})
.catch(error => console.error('Error:', error));
import requests
import json
access_token = "<YOUR_ACCESS_TOKEN>"
dataset_id = "<DATASET_ID>"
product_epd_id = "<PRODUCT_EPD_ID>"
url = f"https://developer.api.autodesk.com/sustainability/v3/datasets/{dataset_id}/product-epds/details/{product_epd_id}/impacts:filter"
headers = {
'Authorization': f'Bearer {access_token}',
'Content-Type': 'application/json',
'Accept': 'application/json'
}
response = requests.post(url, headers=headers, json={"filters": {}})
if response.status_code == 200:
data = response.json()
impacts = data['results']
print(f"=== Impact Indicators ({len(impacts)} indicators found) ===\n")
for index, impact in enumerate(impacts):
print(f"\n--- Indicator {index + 1}: {impact['indicator'].upper()} ---")
print(f"Methodology: {impact['methodology']}")
if 'declaredUnit' in impact and impact['declaredUnit']:
print(f"Declared Unit: {impact['declaredUnit']['qty']} {impact['declaredUnit']['unit']}")
# Display lifecycle stages with values
stages = [
('A1-A3 (Raw Materials & Manufacturing)', 'a1a2a3'),
('A4 (Transport)', 'a4'),
('A5 (Installation)', 'a5'),
('B1 (Use)', 'b1'),
('B2 (Maintenance)', 'b2'),
('B3 (Repair)', 'b3'),
('B4 (Replacement)', 'b4'),
('B5 (Refurbishment)', 'b5'),
('C1 (Deconstruction)', 'c1'),
('C2 (Transport to Disposal)', 'c2'),
('C3 (Waste Processing)', 'c3'),
('C4 (Disposal)', 'c4'),
('D (Beyond System Boundary)', 'd')
]
print('\nLifecycle Stages:')
for stage_name, stage_key in stages:
stage_data = impact.get(stage_key)
if stage_data and stage_data.get('qty') is not None and stage_data.get('unit') is not None:
output = f" {stage_name}: {stage_data['qty']} {stage_data['unit']}"
if 'referencePeriod' in stage_data and stage_data['referencePeriod']:
ref_period = stage_data['referencePeriod']
output += f" (over {ref_period['qty']} {ref_period['unit']})"
print(output)
else:
print(f"Error: {response.status_code} - {response.text}")
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
public class ImpactIndicatorsService
{
private readonly HttpClient _httpClient;
public ImpactIndicatorsService()
{
_httpClient = new HttpClient();
}
public async Task GetImpactIndicatorsAsync(string accessToken, string datasetId, string productEpdId)
{
string url = $"https://developer.api.autodesk.com/sustainability/v3/datasets/{datasetId}/product-epds/details/{productEpdId}/impacts:filter";
_httpClient.DefaultRequestHeaders.Clear();
_httpClient.DefaultRequestHeaders.Add("Authorization", $"Bearer {accessToken}");
_httpClient.DefaultRequestHeaders.Add("Accept", "application/json");
var requestBody = new StringContent("{\"filters\": {}}", Encoding.UTF8, "application/json");
try
{
HttpResponseMessage response = await _httpClient.PostAsync(url, requestBody);
response.EnsureSuccessStatusCode();
string responseContent = await response.Content.ReadAsStringAsync();
JObject data = JObject.Parse(responseContent);
JArray impacts = (JArray)data["results"];
Console.WriteLine($"=== Impact Indicators ({impacts.Count} indicators found) ===\n");
for (int i = 0; i < impacts.Count; i++)
{
var impact = impacts[i];
Console.WriteLine($"\n--- Indicator {i + 1}: {impact["indicator"]?.ToString().ToUpper()} ---");
Console.WriteLine($"Methodology: {impact["methodology"]}");
if (impact["declaredUnit"] != null)
{
Console.WriteLine($"Declared Unit: {impact["declaredUnit"]["qty"]} {impact["declaredUnit"]["unit"]}");
}
var stages = new[]
{
("A1-A3 (Raw Materials & Manufacturing)", "a1a2a3"),
("A4 (Transport)", "a4"),
("A5 (Installation)", "a5"),
("B1 (Use)", "b1"),
("B2 (Maintenance)", "b2"),
("B3 (Repair)", "b3"),
("B4 (Replacement)", "b4"),
("B5 (Refurbishment)", "b5"),
("C1 (Deconstruction)", "c1"),
("C2 (Transport to Disposal)", "c2"),
("C3 (Waste Processing)", "c3"),
("C4 (Disposal)", "c4"),
("D (Beyond System Boundary)", "d")
};
Console.WriteLine("\nLifecycle Stages:");
foreach (var (stageName, stageKey) in stages)
{
var stageData = impact[stageKey];
if (stageData != null && stageData["qty"] != null && stageData["unit"] != null)
{
string output = $" {stageName}: {stageData["qty"]} {stageData["unit"]}";
if (stageData["referencePeriod"] != null)
{
var refPeriod = stageData["referencePeriod"];
output += $" (over {refPeriod["qty"]} {refPeriod["unit"]})";
}
Console.WriteLine(output);
}
}
}
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
Step 2: Understanding the Response
The response provides comprehensive environmental impact data across different lifecycle stages following LCA (Life Cycle Assessment) methodology.
Example Response
{
"results": [
{
"declaredUnit": {
"qty": 1,
"unit": "m3"
},
"indicator": "gwp",
"methodology": "TRACI2.1",
"a1": null,
"a2": null,
"a3": null,
"a1a2a3": {
"qty": 12.5,
"unit": "kgCO2eq"
},
"a4": {
"qty": 2.3,
"unit": "kgCO2eq"
},
"a5": {
"qty": 0.8,
"unit": "kgCO2eq"
},
"b1": {
"qty": 0.5,
"unit": "kgCO2eq",
"referencePeriod": {
"qty": 50,
"unit": "year"
}
},
"b2": null,
"b3": null,
"b4": null,
"b5": null,
"b1b2b3b4b5": {
"qty": 0.5,
"unit": "kgCO2eq",
"referencePeriod": {
"qty": 50,
"unit": "year"
}
},
"c1": {
"qty": 0.2,
"unit": "kgCO2eq"
},
"c2": null,
"c3": null,
"c4": {
"qty": 0.05,
"unit": "kgCO2eq"
},
"c1c2c3c4": {
"qty": 0.25,
"unit": "kgCO2eq"
},
"d": null
},
{
"declaredUnit": {
"qty": 1,
"unit": "m3"
},
"indicator": "gwp_biogenic",
"methodology": "TRACI2.1",
"a1": null,
"a2": null,
"a3": null,
"a1a2a3": {
"qty": -2.1,
"unit": "kgCO2eq"
},
"a4": null,
"a5": null,
"b1": null,
"b2": null,
"b3": null,
"b4": null,
"b5": null,
"b1b2b3b4b5": null,
"c1": null,
"c2": null,
"c3": null,
"c4": null,
"c1c2c3c4": null,
"d": null
}
],
"appliedFilters": {},
"ignoredFilters": {}
}
Key Response Fields:
results: Array of impact indicators, each with lifecycle stage dataindicator: Type of environmental impact (gwp, adpe, ap, etc.)methodology: Assessment standard used (e.g., TRACI2.1, EN 15804+A2)declaredUnit: Reference unit for the measurementsa1a2a3: Product stage impacts (raw materials, transport, manufacturing)a4/a5: Construction stage impacts (transport, installation)b1-b5: Use stage impacts (operation, maintenance, repair, etc.)b1b2b3b4b5: Aggregate use stage impacts (sum of B1-B5)c1-c4: End-of-life stage impacts (deconstruction, disposal)c1c2c3c4: Aggregate end-of-life stage impacts (sum of C1-C4)d: Benefits and loads beyond system boundaryreferencePeriod: Time period for B-stage impacts (e.g., 50 years)appliedFilters: Map of filter keys to the requested vs. applied filter values (with optional warnings when a value was dropped)appliedFilters.*.requested: The filter value the client asked for (object withopandvalue)appliedFilters.*.applied: The filter value the connector actually applied (object withopandvalue)appliedFilters.*.warnings: Optional human-readable notes about values that could not be appliedignoredFilters: Map of unrecognised filter keys to the reason they were ignoredignoredFilters.*.reason: Human-readable explanation of why the filter key was not used
Step 3: Understanding Impact Indicators
Common Impact Indicator Types:
- GWP (Global Warming Potential)
- Measures carbon footprint and climate change impact
- Units: kgCO2eq (kilograms of CO2 equivalent)
- Variants: gwp (total), gwp_fossil, gwp_biogenic, gwp_luluc
- ADPE (Abiotic Depletion Potential - Elements)
- Measures depletion of mineral resources
- Units: kg Sb eq (antimony equivalent)
- ADPF (Abiotic Depletion Potential - Fossil)
- Measures depletion of fossil fuel resources
- Units: MJ (megajoules)
- AP (Acidification Potential)
- Measures acid rain and soil acidification
- Units: kg SO2 eq or mol H+ eq
- EP (Eutrophication Potential)
- Measures nutrient pollution in water bodies
- Variants: ep_freshwater, ep_marine, ep_terrestrial
- Units: kg N eq or kg P eq
- ODP (Ozone Depletion Potential)
- Measures stratospheric ozone layer depletion
- Units: kg CFC-11 eq
- POCP (Photochemical Ozone Creation Potential)
- Measures smog formation potential
- Units: kg NMVOC eq
- WDP (Water Deprivation Potential)
- Measures water scarcity impact
- Units: m3 world eq
Understanding Lifecycle Stages:
Product Stage (A1-A3):
- A1: Raw material extraction and processing
- A2: Transport to manufacturer
- A3: Manufacturing
Construction Stage (A4-A5):
- A4: Transport to construction site
- A5: Installation and construction process
Use Stage (B1-B5):
- B1: Use (direct emissions during use)
- B2: Maintenance
- B3: Repair
- B4: Replacement
- B5: Refurbishment
- Note: B-stages often include a reference period (e.g., impacts over 50 years)
End-of-Life Stage (C1-C4):
- C1: Deconstruction and demolition
- C2: Transport to waste processing
- C3: Waste processing
- C4: Final disposal
Beyond System Boundary (D):
- Benefits from recycling, energy recovery, or reuse
- Often shows negative values (environmental benefits)
Step 4: Practical Applications
Comparing Materials:
Use impact indicators to compare environmental performance:
# Compare GWP across two products
product_a_gwp = 12.5 # kgCO2eq
product_b_gwp = 8.3 # kgCO2eq
difference = product_a_gwp - product_b_gwp
print(f"Product B has {difference} kgCO2eq lower GWP")
print(f"Percentage reduction: {(difference/product_a_gwp)*100:.1f}%")
Analyzing Lifecycle Hotspots:
Identify which lifecycle stages contribute most to impacts:
# Calculate total impact across all stages
stages = {
'Product (A1-A3)': 12.5,
'Construction (A4-A5)': 3.1,
'Use (B1-B5)': 0.5,
'End-of-Life (C1-C4)': 0.55,
'Beyond Boundary (D)': -2.1
}
total = sum(stages.values())
print("Impact Distribution:")
for stage, value in stages.items():
percentage = (value / total) * 100
print(f"{stage}: {percentage:.1f}%")
Calculating Whole-Life Carbon:
Sum impacts across all relevant stages:
# Whole-life carbon calculation
a_stages = 12.5 + 2.3 + 0.8 # A1-A3 + A4 + A5
b_stages = 0.5 # Use stage impacts
c_stages = 0.2 + 0.1 + 0.05 # End-of-life
d_stage = -2.1 # Benefits beyond boundary
whole_life_carbon = a_stages + b_stages + c_stages + d_stage
print(f"Whole-life carbon: {whole_life_carbon} kgCO2eq")
Integration Best Practices:
- Store and cache impact data for multiple products to enable comparison
- Track methodology to ensure you’re comparing like-with-like
- Consider all stages relevant to your use case (not just A1-A3)
- Account for reference periods when analyzing B-stage impacts
- Check for null values as not all stages may have data available
- Use declared units to normalize comparisons across different products
Common Use Cases:
- Material Selection: Compare GWP of concrete vs. steel for structural elements
- Compliance Reporting: Calculate embodied carbon for LEED, BREEAM certifications
- Supply Chain Optimization: Identify high-impact suppliers (A1-A3 data)
- Design Optimization: Analyze impact of design alternatives
- Whole Building LCA: Aggregate impacts across all building components
- Circular Economy: Evaluate benefits of material reuse/recycling (Stage D)
Data Quality Considerations:
- Not all EPDs include all lifecycle stages
- B-stage data often requires building-specific assumptions
- Reference periods may vary between EPDs (e.g., 25 vs. 50 years)
- Methodology differences affect comparability
- Always verify data completeness before making decisions
Troubleshooting:
If you encounter any errors while making this request, please refer to the Error Handling section of this guide for detailed information about common error codes and their solutions.