Request

Response

    Get Baselines Filters
    GET

    v3/datasets/{datasetId}/baselines/filters

    Retrieves filter metadata for baselines available for the specified dataset.

    Resource Information

    Method and URI
    GET
    https://developer.api.autodesk.com/sustainability/v3/datasets/{datasetId}/baselines/filters
    Authentication Context
    User context required
    Required OAuth Scopes
    data:read
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    Must be Bearer <token>, where <token> is a three-legged access token obtained via an Authorization Code flow or a Secure Service Account (SSA) flow.

    The SSA flow is designed for headless server-to-server operations. While it functions like a two-legged flow (no user interaction), it is classified as three-legged because it preserves user context.

    * Required

    Request

    URI Parameters

    datasetId
    string
    Unique identifier for the dataset. Use this value as the datasetId URI parameter in API requests to access that dataset’s data.

    Response

    HTTP Status Code Summary

    200
    OK
    Filter metadata for the dataset.
    400
    Bad Request
    The request could not be processed due to invalid or malformed data. Check the request parameters, body format, and required fields before retrying.
    401
    Unauthorized
    The supplied authorization header was invalid or the token scope was not acceptable. Verify your authentication credentials and try again.
    403
    Forbidden
    The request was valid but lacked the necessary permissions. Verify your credentials and permissions before sending the request again.
    404
    Not Found
    The requested resource could not be found on the server. Review the request and try again.
    422
    Unprocessable Entity
    The dataset does not declare the data type required by this route in supportedDataTypes. Use GET /v3/datasets to inspect supportedDataTypes for the dataset.
    424
    The request could not be completed because the data provider failed or does not support this operation. Inspect the response body’s type, title, and detail fields to determine the cause: NOT_FOUND means the operation is unsupported for this dataset; AUTH_ERROR means the provider could not authenticate the request due to invalid credentials or token; RESOURCE_NOT_FOUND means the requested resource could not be found; REQUEST_LIMIT_EXCEEDED means the data provider has reached its request limit. Please reach out to them; UNKNOWN means the provider encountered an unexpected error.

    Response

    Body Structure (200)

    Expand all
    resource
    enum:string
    Resource this metadata applies to. Will always be: baselines
    actions
    object
    Per-action filtering contract. Valid keys are list, categories, and impacts. Omit keys for actions this connector does not expose.
    list
    object
    Partner path and filter contract for one :filter surface. The path must match the action (e.g. /{resource}/categories:filter for categories, not the list path).
    path
    string
    Partner path for this action’s :filter endpoint.
    label
    string
    Human-readable label specific to this action (list vs categories, etc.).
    filters
    array: object
    List of filters supported by this action.
    id
    string
    Filter key supported by this action.
    required
    boolean
    Whether this filter is required for this action.
    default
    one of
    Suggested default when the client omits this filter: a string, number, or boolean scalar, or a homogeneous string[] or number[] of zero or more elements. Boolean arrays are not supported.
    0
    string
    1
    number
    2
    boolean
    3
    array: string
    4
    array: number
    categories
    object
    Partner path and filter contract for one :filter surface. The path must match the action (e.g. /{resource}/categories:filter for categories, not the list path).
    path
    string
    Partner path for this action’s :filter endpoint.
    label
    string
    Human-readable label specific to this action (list vs categories, etc.).
    filters
    array: object
    List of filters supported by this action.
    id
    string
    Filter key supported by this action.
    required
    boolean
    Whether this filter is required for this action.
    default
    one of
    Suggested default when the client omits this filter: a string, number, or boolean scalar, or a homogeneous string[] or number[] of zero or more elements. Boolean arrays are not supported.
    0
    string
    1
    number
    2
    boolean
    3
    array: string
    4
    array: number
    impacts
    object
    Partner path and filter contract for one :filter surface. The path must match the action (e.g. /{resource}/categories:filter for categories, not the list path).
    path
    string
    Partner path for this action’s :filter endpoint.
    label
    string
    Human-readable label specific to this action (list vs categories, etc.).
    filters
    array: object
    List of filters supported by this action.
    id
    string
    Filter key supported by this action.
    required
    boolean
    Whether this filter is required for this action.
    default
    one of
    Suggested default when the client omits this filter: a string, number, or boolean scalar, or a homogeneous string[] or number[] of zero or more elements. Boolean arrays are not supported.
    0
    string
    1
    number
    2
    boolean
    3
    array: string
    4
    array: number
    filters
    object
    Map of filter identifier to definition. Keys are filter ids and must match id values referenced under actions.
    *
    object
    Definition for a filter field. Keys in the parent filters map must match id values referenced under actions.
    label
    string
    Human-readable filter name.
    field
    string
    Field identifier used by the connector for filtering semantics.
    dataType
    string
    Data type of the filter value.
    operators
    array: string
    Supported operators for the filter.
    supportsMultiple
    boolean
    Whether multiple values are supported for this filter.
    valueSource
    one of
    Describes how allowable values for a filter are obtained. When type is dynamic, endpoint must be present. When type is implicit, no endpoint is used. Filter ids, operators, and value sources are declared by each provider in the discovery response. The platform does not guarantee a single universal pattern for how implicit filters expose their values.
    0
    object
    type
    enum:string
    Clients must determine valid inputs from the filter metadata or from the provider documentation. Implicit filters do not offer a dedicated endpoint to retrieve allowed values. Will always be: implicit
    1
    object
    type
    enum:string
    Allowed values may vary by dataset and are retrieved via the filter-values endpoint referenced in valueSource.endpoint. Will always be: dynamic
    endpoint
    string
    Endpoint to retrieve allowed values (partner-relative path).
    description
    string
    Human-readable description of the filter.

    Example

    Filter metadata for the dataset.

    Request

    curl -v 'https://developer.api.autodesk.com/sustainability/v3/datasets/f81d4fae-7dec-11d0-a765-00a0c91e6bf6/baselines/filters' \
      -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
    

    Response

    {
      "resource": "baselines",
      "actions": {
        "list": {
          "path": "/product-epds/categories:filter",
          "label": "Categories",
          "filters": [
            {
              "id": "jurisdictions",
              "required": false,
              "default": "US"
            }
          ]
        },
        "categories": {
          "path": "/product-epds/categories:filter",
          "label": "Categories",
          "filters": [
            {
              "id": "jurisdictions",
              "required": false,
              "default": "US"
            }
          ]
        },
        "impacts": {
          "path": "/product-epds/categories:filter",
          "label": "Categories",
          "filters": [
            {
              "id": "jurisdictions",
              "required": false,
              "default": "US"
            }
          ]
        }
      },
      "filters": {
        "category_id": {
          "label": "Category ID",
          "field": "id",
          "dataType": "string",
          "operators": [
            "EQ"
          ],
          "supportsMultiple": false,
          "valueSource": {
            "type": "dynamic",
            "endpoint": "/baselines/filters/category_id"
          }
        }
      }
    }
    
    Show More