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:
| Operation | HTTP Request |
|---|---|
| Get Industry EPD Details | GET /v3/datasets/{datasetId}/industry-epds/details/{industryEpdId} |
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 Industry EPDs and obtained an industry EPD ID from the industry EPDs list
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));
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}")
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}");
}
}
}
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"
}
Key Response Fields:
id: Unique identifier for the industry EPDname: Display name of the industry EPDcategoryIds: Array of category identifiers (empty array if none specified)description: Detailed industry EPD 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 industry EPDpublishers: 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.