Request

Response

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

    Get Industry EPD Details

    This task shows you how to retrieve detailed information about a specific industry EPD, including publisher details and technical specifications. This endpoint provides comprehensive metadata about individual EPDs that you discovered in previous tasks.

    By the end of this task, you will know how to:

    • Call the industry EPD details endpoint using an EPD ID
    • Interpret detailed EPD information
    • Understand publisher information and technical specifications

    You use the following operation for this task:

    OperationHTTP Request
    Get Industry EPD Details GET /v3/datasets/{datasetId}/industry-epds/details/{industryEpdId}

    Prerequisites

    Before starting this task, ensure you have:


    Step 1: Call the Industry EPD Details 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 details about 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>' \
      -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
      -H 'Accept: application/json'
    
    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}`;
    
    fetch(url, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Accept': 'application/json'
      }
    })
    .then(response => response.json())
    .then(data => {
      const epd = data.industryEpd;
    
      console.log('=== Industry EPD Details ===');
      console.log(`Name: ${epd.name}`);
      console.log(`Description: ${epd.description || 'N/A'}`);
      console.log(`Version: ${epd.version || 'N/A'}`);
    
      console.log('\n=== Validity Information ===');
      console.log(`Date of Issue: ${epd.dateOfIssue || 'N/A'}`);
      console.log(`Valid Until: ${epd.validUntil || 'N/A'}`);
      console.log(`Jurisdictions: ${(epd.jurisdictions || []).join(', ') || 'N/A'}`);
    
      console.log('\n=== Declared Unit ===');
      if (epd.declaredUnit) {
        console.log(`Quantity: ${epd.declaredUnit.qty} ${epd.declaredUnit.unit}`);
      } else {
        console.log('Declared unit not available');
      }
    
      console.log('\n=== Publisher Information ===');
      if (epd.publishers && epd.publishers.length > 0) {
        epd.publishers.forEach((publisher, index) => {
          console.log(`Publisher ${index + 1}:`);
          console.log(`  Name: ${publisher.name || 'N/A'}`);
          console.log(`  Website: ${publisher.url || 'N/A'}`);
        });
      } else {
        console.log('Publisher information not available');
      }
    
      console.log('\n=== Additional Information ===');
      console.log(`Declaration URL: ${epd.declarationUrl || 'N/A'}`);
      console.log(`Cache Refresh: ${data.cacheRefreshTimestamp || 'N/A'}`);
    })
    .catch(error => console.error('Error:', error));
    
    Show More
    import requests
    
    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}"
    
    headers = {
        'Authorization': f'Bearer {access_token}',
        'Accept': 'application/json'
    }
    
    response = requests.get(url, headers=headers)
    
    if response.status_code == 200:
        data = response.json()
        epd = data['industryEpd']
    
        print('=== Industry EPD Details ===')
        print(f"Name: {epd.get('name', 'N/A')}")
        print(f"Description: {epd.get('description', 'N/A')}")
        print(f"Version: {epd.get('version', 'N/A')}")
    
        print('\n=== Validity Information ===')
        print(f"Date of Issue: {epd.get('dateOfIssue', 'N/A')}")
        print(f"Valid Until: {epd.get('validUntil', 'N/A')}")
        jurisdictions = epd.get('jurisdictions', [])
        print(f"Jurisdictions: {', '.join(jurisdictions) if jurisdictions else 'N/A'}")
    
        print('\n=== Declared Unit ===')
        declared_unit = epd.get('declaredUnit')
        if declared_unit and 'qty' in declared_unit and 'unit' in declared_unit:
            print(f"Quantity: {declared_unit['qty']} {declared_unit['unit']}")
        else:
            print('Declared unit not available')
    
        print('\n=== Publisher Information ===')
        publishers = epd.get('publishers', [])
        if publishers:
            for i, publisher in enumerate(publishers, 1):
                print(f"Publisher {i}:")
                print(f"  Name: {publisher.get('name', 'N/A')}")
                print(f"  Website: {publisher.get('url', 'N/A')}")
        else:
            print('Publisher information not available')
    
        print('\n=== Additional Information ===')
        print(f"Declaration URL: {epd.get('declarationUrl', 'N/A')}")
        print(f"Cache Refresh: {data.get('cacheRefreshTimestamp', 'N/A')}")
    else:
        print(f"Error: {response.status_code} - {response.text}")
    
    Show More
    using System;
    using System.Net.Http;
    using System.Threading.Tasks;
    using Newtonsoft.Json;
    
    public class IndustryEpdDetailsService
    {
        private readonly HttpClient _httpClient;
    
        public IndustryEpdDetailsService()
        {
            _httpClient = new HttpClient();
        }
    
        public async Task GetIndustryEpdDetailsAsync(string accessToken, string datasetId, string industryEpdId)
        {
            string url = $"https://developer.api.autodesk.com/sustainability/v3/datasets/{datasetId}/industry-epds/details/{industryEpdId}";
    
            _httpClient.DefaultRequestHeaders.Clear();
            _httpClient.DefaultRequestHeaders.Add("Authorization", $"Bearer {accessToken}");
            _httpClient.DefaultRequestHeaders.Add("Accept", "application/json");
    
            try
            {
                HttpResponseMessage response = await _httpClient.GetAsync(url);
                response.EnsureSuccessStatusCode();
    
                string responseContent = await response.Content.ReadAsStringAsync();
                dynamic data = JsonConvert.DeserializeObject(responseContent);
                var epd = data.industryEpd;
    
                Console.WriteLine("=== Industry EPD Details ===");
                Console.WriteLine($"Name: {epd.name ?? "N/A"}");
                Console.WriteLine($"Description: {epd.description ?? "N/A"}");
                Console.WriteLine($"Version: {epd.version ?? "N/A"}");
    
                Console.WriteLine("\n=== Validity Information ===");
                Console.WriteLine($"Date of Issue: {epd.dateOfIssue ?? "N/A"}");
                Console.WriteLine($"Valid Until: {epd.validUntil ?? "N/A"}");
                string jurisdictions = epd.jurisdictions != null ? string.Join(", ", epd.jurisdictions) : "N/A";
                Console.WriteLine($"Jurisdictions: {jurisdictions}");
    
                Console.WriteLine("\n=== Declared Unit ===");
                if (epd.declaredUnit != null && epd.declaredUnit.qty != null && epd.declaredUnit.unit != null)
                {
                    Console.WriteLine($"Quantity: {epd.declaredUnit.qty} {epd.declaredUnit.unit}");
                }
                else
                {
                    Console.WriteLine("Declared unit not available");
                }
    
                Console.WriteLine("\n=== Publisher Information ===");
                if (epd.publishers != null && epd.publishers.Count > 0)
                {
                    for (int i = 0; i < epd.publishers.Count; i++)
                    {
                        var publisher = epd.publishers[i];
                        Console.WriteLine($"Publisher {i + 1}:");
                        Console.WriteLine($"  Name: {publisher.name ?? "N/A"}");
                        Console.WriteLine($"  Website: {publisher.url ?? "N/A"}");
                    }
                }
                else
                {
                    Console.WriteLine("Publisher information not available");
                }
    
                Console.WriteLine("\n=== Additional Information ===");
                Console.WriteLine($"Declaration URL: {epd.declarationUrl ?? "N/A"}");
                Console.WriteLine($"Cache Refresh: {data.cacheRefreshTimestamp ?? "N/A"}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
    
    Show More

    Step 2: Understanding the Response

    The response provides comprehensive details about the industry EPD, including publisher information, and technical specifications.

    Example Response

    {
      "industryEpd": {
        "id": "9e8d99c10e2a46f581026c80233eb10a",
        "name": "Wood I-Joists",
        "categoryIds": [
          "cat-masterformat-060000"
        ],
        "description": "Frequently classified as an engineered wood product.",
        "jurisdictions": ["CA", "US"],
        "dateOfIssue": "2013-07-23",
        "validUntil": "2018-07-23",
        "declarationUrl": "https://buildingtransparency.org/ec3/industry-epds/ec3ggjej",
        "declaredUnit": {
          "qty": 1,
          "unit": "m3"
        },
        "publishers": [
          {
            "name": "Green Building Materials Inc.",
            "url": "https://www.example.com"
          }
        ],
        "version": "1.0"
      },
      "cacheRefreshTimestamp": "2021-06-01T00:00:00Z"
    }
    
    Show More

    Key Response Fields:

    • id: Unique identifier for the industry EPD
    • name: Display name of the industry EPD
    • categoryIds: Array of category identifiers (empty array if none specified)
    • description: Detailed industry EPD description (may be null)
    • version: EPD document version (may be null)
    • dateOfIssue / validUntil: EPD validity period (may be null)
    • jurisdictions: Geographic regions where EPD applies (may be empty)
    • declarationUrl: Link to original EPD document (may be null)
    • declaredUnit.qty / declaredUnit.unit: Measurement unit for the industry EPD
    • publishers: Array of publisher information including name and website (may be empty)
    • cacheRefreshTimestamp: When data was last updated from provider

    Step 3: Working with Industry EPD Details

    Environmental Impact Data:

    For detailed environmental impact metrics and LCA data, use the next task on Industry EPD Impact Indicators which provides comprehensive lifecycle assessment information.

    Practical Applications:

    • Industry Research: Access detailed industry EPD specifications and documentation
    • Compliance Verification: Check validity dates and jurisdictions
    • Documentation: Access original EPD declarations for detailed analysis
    • Publisher Contact: Use publisher information for additional resources
    • Impact Analysis: Use the industry EPD ID to retrieve impact indicators via Industry EPD Impact Indicators

    Data Validation:

    Always check for null values as EPD completeness varies by provider: - Some fields may be null or missing depending on data availability - Use the cacheRefreshTimestamp to understand data freshness - Verify validUntil dates for compliance requirements - Publishers array may be empty if no publisher information is available

    Integration Tips:

    • Store EPD IDs for future reference and comparison
    • Cache detailed EPD data to minimize API calls
    • Use publisher URLs for additional EPD information
    • Compare multiple industry EPDs to evaluate different product options
    • Handle publishers as an array - there may be multiple publishers for a single EPD

    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.