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:
| Operation | HTTP Request |
|---|---|
| Get Product EPD Details | GET /v3/datasets/{datasetId}/product-epds/details/{productEpdId} |
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 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));
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}")
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}");
}
}
}
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"
}
Key Response Fields:
id: Unique identifier for the product EPDname: Display name of the productcategoryIds: Array of category identifiers (empty array if none specified)description: Detailed product description (may benull)version: EPD document version (may benull)dateOfIssue/validUntil: EPD validity period (may benull)jurisdictions: Geographic regions where EPD applies (may be empty)declarationUrl: Link to original EPD document (may benull)declaredUnit.qty/declaredUnit.unit: Measurement unit for the productmanufacturer: Company information including name and website (may benull)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.