Request

Response

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

    Get Product EPD Details

    This task shows you how to retrieve detailed information about a specific product EPD, including manufacturer 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 product EPD details endpoint using an EPD ID
    • Interpret detailed EPD information
    • Understand manufacturer information and technical specifications

    You use the following operation for this task:

    OperationHTTP Request
    Get Product EPD Details GET /v3/datasets/{datasetId}/product-epds/details/{productEpdId}

    Prerequisites

    Before starting this task, ensure you have:


    Step 1: Call the Product EPD Details 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 details about 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>' \
      -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
      -H 'Accept: application/json'
    
    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}`;
    
    fetch(url, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Accept': 'application/json'
      }
    })
    .then(response => response.json())
    .then(data => {
      const epd = data.productEpd;
    
      console.log('=== Product 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=== Manufacturer Information ===');
      if (epd.manufacturer) {
        console.log(`Name: ${epd.manufacturer.name || 'N/A'}`);
        console.log(`Website: ${epd.manufacturer.url || 'N/A'}`);
      } else {
        console.log('Manufacturer 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>"
    product_epd_id = "<PRODUCT_EPD_ID>"
    url = f"https://developer.api.autodesk.com/sustainability/v3/datasets/{dataset_id}/product-epds/details/{product_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['productEpd']
    
        print('=== Product 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=== Manufacturer Information ===')
        manufacturer = epd.get('manufacturer')
        if manufacturer:
            print(f"Name: {manufacturer.get('name', 'N/A')}")
            print(f"Website: {manufacturer.get('url', 'N/A')}")
        else:
            print('Manufacturer 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 ProductEpdDetailsService
    {
        private readonly HttpClient _httpClient;
    
        public ProductEpdDetailsService()
        {
            _httpClient = new HttpClient();
        }
    
        public async Task GetProductEpdDetailsAsync(string accessToken, string datasetId, string productEpdId)
        {
            string url = $"https://developer.api.autodesk.com/sustainability/v3/datasets/{datasetId}/product-epds/details/{productEpdId}";
    
            _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.productEpd;
    
                Console.WriteLine("=== Product 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=== Manufacturer Information ===");
                if (epd.manufacturer != null)
                {
                    Console.WriteLine($"Name: {epd.manufacturer.name ?? "N/A"}");
                    Console.WriteLine($"Website: {epd.manufacturer.url ?? "N/A"}");
                }
                else
                {
                    Console.WriteLine("Manufacturer 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 product EPD, including manufacturer information, and technical specifications.

    Example Response

    {
      "productEpd": {
        "id": "b03dba1dca5b49acb1a5aa4daab546b4",
        "name": "Standard Concrete Block",
        "categoryIds": [
          "cat-masterformat-030000"
        ],
        "description": "Lightweight aggregate concrete masonry units manufactured using expanded clay, shale, and slate.",
        "jurisdictions": ["US-CA"],
        "dateOfIssue": "2023-01-15",
        "validUntil": "2028-01-15",
        "declarationUrl": "https://example.com/epd/b03dba1dca5b49acb1a5aa4daab546b4",
        "declaredUnit": {
          "qty": 1,
          "unit": "m3"
        },
        "manufacturer": {
          "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 product EPD
    • name: Display name of the product
    • categoryIds: Array of category identifiers (empty array if none specified)
    • description: Detailed product 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 product
    • manufacturer: Company information including name and website (may be null)
    • cacheRefreshTimestamp: When data was last updated from provider

    Step 3: Working with Product EPD Details

    Environmental Impact Data:

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

    Practical Applications:

    • Product Research: Access detailed product specifications and documentation
    • Compliance Verification: Check validity dates and jurisdictions
    • Documentation: Access original EPD declarations for detailed analysis
    • Manufacturer Contact: Use manufacturer information for procurement
    • Impact Analysis: Use the product EPD ID to retrieve impact indicators via Filter Product EPDs Categories

    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

    Integration Tips:

    • Store EPD IDs for future reference and comparison
    • Cache detailed EPD data to minimize API calls
    • Use manufacturer URLs for additional product information
    • Compare multiple product EPDs to evaluate different product options

    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.