Request

Response

    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:

    1. 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.

    2. 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.