Retrieve a worker labor time report
GET
reports/worker-labor-time
Retrieves a paginated list of the labor time by Worker, optionally filtered. Sorted by date. When additional results are available, the pagination object in the response payload provides a “nextUrl” that links to the next page of results.
Resource Information
| Method and URI | GET https://api.aps.autodesk.com/fusion-operations/v2/reports/worker-labor-time |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Query String Parameters
| filter[date] string | Days considered by the report. The maximum range supported is one month |
| filter[worker.id] int | Filter labor time by Worker, providing the id. |
| filter[worker.number] int | Filter labor time by Worker, providing the number. |
| filter[section.id] int | Filter labor time by Workers section, providing the id. |
| filter[section.name] string | Filter labor time by Workers section, providing the name. Pass the value as URL‑encoded. |
| filter[showRework] boolean | Include rework operations in the report |
| filter[showWeekend] boolean | Include the weekend days in the report |
| filter[onlyPunchClock] boolean | Only consider presence time with punch clock entries |
| limit int | Maximum number of results returned. Defaults to 25. |
| offset int | Page offset. Default value is 0. |
Response
HTTP Status Code Summary
| 200 OK | The report of worker labor time. |
| 400 Bad Request | Bad request due to invalid data. |
| 401 Unauthorized | The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request. |
| 403 Forbidden | The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request. |
| 429 Too Many Requests | Rate limit exceeded; wait some time before retrying. |
| 500 Internal Server Error | An unknown server-side error occurred. Please try again later. If the problem persists, please contact support. |
Response
Header (429)
| Retry-After integer | The number of seconds to wait before retrying the request. |
Response
Body Structure (200)
Expand all
| results array: object | List of Worker labor times by id |
| date string | Day of the labor team (e.g. 2025-06-21) |
| worker | |
| id int | |
| number int | |
| name string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| presenceTime string | Presence Time (ISO 8601 duration, e.g. PT3H15M30S) |
| workTime string | Work Time (ISO 8601 duration, e.g. PT3H15M30S) |
| percentage number | Percentage of the worked time |
| calendarDowntimes string | Calendar downtime (ISO 8601 duration, e.g. PT3H14M30S) |
| pagination object | |
| limit int | Maximum number of results returned in this page. |
| offset int | Number of results skipped before this page. |
| nextUrl string | URL for the next page of results. Null when there are no additional pages. |
Example
The report of worker labor time.
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/reports/worker-labor-time' \
-H 'Authorization: '
Response
{
"results": [
{
"date": "2025-05-06",
"worker": {
"id": 12,
"number": 66
},
"presenceTime": "PT12H00M00S",
"workTime": "PT6H00M00S",
"percentage": 50,
"calendarDowntimes": "PT0H00M00S"
},
{
"date": "2025-05-07",
"worker": {
"id": 12,
"number": 66
},
"presenceTime": "PT12H00M00S",
"workTime": "PT8H00M00S",
"percentage": 66.66,
"calendarDowntimes": "PT0H00M00S"
},
{
"date": "2025-05-06",
"worker": {
"id": 13,
"number": 67
},
"presenceTime": "PT08H00M00S",
"workTime": "PT6H00M00S",
"percentage": 75,
"calendarDowntimes": "PT0H00M00S"
},
{
"date": "2025-05-07",
"worker": {
"id": 13,
"number": 67
},
"presenceTime": "PT08H00M00S",
"workTime": "PT8H00M00S",
"percentage": 100,
"calendarDowntimes": "PT0H00M00S"
}
],
"pagination": {
"limit": 20,
"offset": 0,
"nextUrl": null
}
}
Show More