Request

Response

    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