Request

Response

    Beta APIs are subject to change. Please avoid using them in production environments.

    Filter Industry EPD Impact Indicators

    This task shows you how to retrieve and filter environmental impact indicators for a specific industry 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:

    OperationHTTP Request
    Filter Impact Indicators for IndustryEPD POST /v3/datasets/{datasetId}/industry-epds/details/{industryEpdId}/impacts:filter

    Prerequisites

    Before starting this task, ensure you have:


    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 an industry EPD ID from Filter Industry EPDs to retrieve impact indicators for a specific industry EPD.

    Replace <YOUR_ACCESS_TOKEN>, <DATASET_ID>, and <INDUSTRY_EPD_ID> with your values.

    curl -v 'https://developer.api.autodesk.com/sustainability/v3/datasets/<DATASET_ID>/industry-epds/details/<INDUSTRY_EPD_ID>/impacts:filter' \
      -X 'POST' \
      -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -d '{
        "filters": {}
      }'
    
    Show More
    const accessToken = "<YOUR_ACCESS_TOKEN>";
    const datasetId = "<DATASET_ID>";
    const industryEpdId = "<INDUSTRY_EPD_ID>";
    const url = `https://developer.api.autodesk.com/sustainability/v3/datasets/${datasetId}/industry-epds/details/${industryEpdId}/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));
    
    Show More
     import requests
     import json
    
     access_token = "<YOUR_ACCESS_TOKEN>"
     dataset_id = "<DATASET_ID>"
     industry_epd_id = "<INDUSTRY_EPD_ID>"
     url = f"https://developer.api.autodesk.com/sustainability/v3/datasets/{dataset_id}/industry-epds/details/{industry_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}")
    
    Show More
    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 industryEpdId)
        {
            string url = $"https://developer.api.autodesk.com/sustainability/v3/datasets/{datasetId}/industry-epds/details/{industryEpdId}/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}");
            }
        }
    }
    
    Show More

    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": {}
    }
    
    Show More

    Key Response Fields:

    • results: Array of impact indicators, each with lifecycle stage data
    • indicator: Type of environmental impact (gwp, adpe, ap, etc.)
    • methodology: Assessment standard used (e.g., TRACI2.1, EN 15804+A2)
    • declaredUnit: Reference unit for the measurements
    • a1a2a3: 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 boundary
    • referencePeriod: 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 with op and value)
    • appliedFilters.*.applied: The filter value the connector actually applied (object with op and value)
    • appliedFilters.*.warnings: Optional human-readable notes about values that could not be applied
    • ignoredFilters: Map of unrecognised filter keys to the reason they were ignored
    • ignoredFilters.*.reason: Human-readable explanation of why the filter key was not used

    Step 3: Understanding Impact Indicators

    Common Impact Indicator Types:

    1. 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
    2. ADPE (Abiotic Depletion Potential - Elements)

      • Measures depletion of mineral resources
      • Units: kg Sb eq (antimony equivalent)
    3. ADPF (Abiotic Depletion Potential - Fossil)

      • Measures depletion of fossil fuel resources
      • Units: MJ (megajoules)
    4. AP (Acidification Potential)

      • Measures acid rain and soil acidification
      • Units: kg SO2 eq or mol H+ eq
    5. EP (Eutrophication Potential)

      • Measures nutrient pollution in water bodies
      • Variants: ep_freshwater, ep_marine, ep_terrestrial
      • Units: kg N eq or kg P eq
    6. ODP (Ozone Depletion Potential)

      • Measures stratospheric ozone layer depletion
      • Units: kg CFC-11 eq
    7. POCP (Photochemical Ozone Creation Potential)

      • Measures smog formation potential
      • Units: kg NMVOC eq
    8. 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}%")
    
    Show More

    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")
    
    Show More

    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:

    1. Material Selection: Compare GWP of concrete vs. steel for structural elements
    2. Compliance Reporting: Calculate embodied carbon for LEED, BREEAM certifications
    3. Supply Chain Optimization: Identify high-impact suppliers (A1-A3 data)
    4. Design Optimization: Analyze impact of design alternatives
    5. Whole Building LCA: Aggregate impacts across all building components
    6. 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.