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
| Filter | USAGE_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.
