Beta APIs are subject to change. Please avoid using them in production environments.
About this Walkthrough
Welcome to the Sustainability Data API Walkthrough. This comprehensive walkthrough will guide you through the essential operations for working with environmental product declarations (EPDs) and sustainability data using the Autodesk Sustainability Data API. You’ll learn to authenticate, discover available datasets, and retrieve environmental data.
Prerequisites
What you’ll need:
- An Autodesk account
- A Developer Hub
Setup Steps:
Before starting this walkthrough, complete these authentication setup steps:
- Create an App: Follow the Create an App guide to obtain a Developer Hub (if you don’t already have one) and generate your Client ID and Client Secret
Warning
When creating your app, you must select Traditional Web App as the App Type.
All other app types use different OAuth flows that are incompatible with 3-Legged authentication.
- Generate Access Token: Use your credentials to generate an access token using the Authorization Code Grant flow of OAuth 2.0
Important Configuration:
- App Type: Set to “Traditional Web App” when creating your app
- API Access: Set to “Sustainability Data API” when creating your app
- Required Scope: Specify
data:read when requesting your access token
What You’ll Learn
In this walkthrough, you’ll progressively learn how to:
Authentication & Setup
Get the List of Supported Datasets - Retrieve the list of supported sustainability datasets available through the API
Baselines
Filter Baselines - Retrieve baseline estimates for benchmarking
Filter Baselines Categories - Retrieve baseline categories using classification systems
Get Baseline Details - Retrieve detailed values and metadata for a specific baseline
Filter Baseline Impact Indicators - Retrieve environmental impact data for baseline estimates
Generic Estimates
Filter Generic Estimates - Retrieve generic estimates for preliminary environmental assessments
Filter Generic Estimates Categories - Retrieve generic estimate categories using classification systems
Get Generic Estimate Details - Retrieve detailed information about specific generic estimates
Filter Generic Estimate Impact Indicators - Retrieve environmental impact data for generic estimates
Industry EPDs
Get Industry EPD Filters - Discover available filters and retrieve allowed values before querying Industry EPDs
Filter Industry EPDs - Retrieve industry-specific EPDs and their metadata
Filter Industry EPDs Categories - Retrieve industry EPD categories using classification systems
Filter Industry EPDs Statistics - Retrieve industry EPD statistics using provider-defined filters
Get Industry EPD Details - Retrieve comprehensive details about individual EPDs
Filter Industry EPD Impact Indicators - Retrieve environmental impact data for specific industry EPDs
Product EPDs
Get Product EPD Filters - Discover available filters and retrieve allowed values before querying Product EPDs
Filter Product EPDs - Retrieve product-specific EPDs and their metadata
Filter Product EPDs Categories - Retrieve product EPD categories using classification systems
Filter Product EPDs Statistics - Retrieve product EPD statistics using provider-defined filters
Get Product EPD Details - Retrieve comprehensive details about individual EPDs
Filter Product EPD Impact Indicators - Retrieve environmental impact data for specific product EPDs
Walkthrough Structure
Each task in this walkthrough builds upon the previous one, creating a logical progression from basic authentication to advanced data filtering and retrieval. The tasks are designed to be completed in order, as later tasks may depend on concepts and data obtained in earlier steps.
By the end of this walkthrough, you’ll have a solid understanding of how to integrate the Sustainability Data API into your applications and workflows, enabling you to make more informed decisions about environmental impacts in your projects.
Next: Once you have your access token, you’re ready to start with the first task: authentication.