Request

Response

    Usage Report

    The Usage Report API provides a way to export Subscription and Flex usage. All the filters available through Usage Report Export APIs are documented here. Filters can be used to restrict data based on certain attributes.

    Filters

    teamId**
    Specific team or all teams
    4314051
    groupId
    Group Ids
    [“101453425”,”101567191”]
    productLineCode
    Product Line Code (Collection)
    [“ACAD”]
    source
    Identifies licensing/metering strategy (sus/flex)
    [“sus”,”flex”]
    assigned
    To get User assigned (true), not assigned (false)
    true
    userStatus
    Active users, Inactive users
    [“active”,”inactive”]
    userId
    User Ids
    [“46AJRYHAP28P4BZQ”,”16MJNFUEP37P3BCX”]
    versionId
    Product versions Ids
    [“2024”,”cloud”]
    startDate*
    Usage Date (UTC) >= startDate
    2022-01-01T00:00:00Z
    endDate*
    Usage Date (UTC) <= endDate
    2022-12-10T00:00:00Z

    * startDate and endDate should be within 1 year (365 days) ** teamId, startDate and endDate are not passed within filters {}, but as a separate attribute in the request body.

    Reports and applicable filters

    FilterUSAGE_REPORT_BY_PRODUCT
    teamId Optional
    groupId Optional
    productLineCode Optional
    source Optional
    assigned Optional
    userStatus Optional
    userId Optional
    versionId Optional
    startDate Required
    endDate Required

    Example: Filter on assigned and userStatus

    curl  -X GET \
          'https://developer.api.autodesk.com/insights/v1/exports' \
          -H 'Content-Type: application/json' \
          -H 'Authorization: Bearer eyJhbGciOiJIUzI1N' \
          -d '{
          "outputFormat": "EXCEL",
          "reports": ["USAGE_REPORT"],
          "startDate": "2020-09-28T05:41:03.268Z",
          "endDate": "2025-11-04T17:22:01.019Z",
          "usageReports": ["USAGE_REPORT_BY_PRODUCT"],
          "filters": {"assigned": true, "userStatus":["active", "inactive"]}
          }'
    
    Show More

    Details

    Brings both active and inactive users sus/flex usage between startDate and endDate that are currently assigned.

    Example: Filter on source and productLineCode

    curl  -X GET \
          'https://developer.api.autodesk.com/insights/v1/exports' \
          -H 'Content-Type: application/json' \
          -H 'Authorization: Bearer eyJhbGciOiJIUzI1N' \
          -d '{
          "outputFormat": "EXCEL",
          "reports": ["USAGE_REPORT"],
          "startDate": "2020-09-28T05:41:03.268Z",
          "endDate": "2025-11-04T17:22:01.019Z",
          "usageReports": ["USAGE_REPORT_BY_PRODUCT"],
          "filters": {"source":["sus"], "productLineCode":["ACD"]}
          }'
    
    Show More

    Details

    Brings both subscription usage between startDate and endDate for specific Product Line/Collection.