Request

Response

    Retrieve Punch Clock Records
    GET

    punch-clock-records

    Retrieves a paginated list of all Punch Clock Record entries, optionally filtered and sorted. 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/punch-clock-records
    Authentication Context
    No security required
    Required OAuth Scopes
    data:read data:write
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    JWT Access Token
    * Required

    Request

    Query String Parameters

    filter[id]
    int
    Filter Punch Clock Records matching the specified id.
    filter[date]
    string
    Filter Punch Clock Records by date. Accepts an ISO-8601 date time or an inclusive date time range in the format lowerValue..upperValue, lowerValue.., or ..upperValue. Returns Punch Clock Records started within the specified range.
    filter[worker.number]
    int
    Filter Punch Clock Records by worker, providing the worker number
    filter[worker.id]
    int
    Filter Punch Clock Records by worker, providing the worker id
    filter[workerGroup.id]
    int
    Filter Punch Clock Records by worker group, providing the worker group id
    filter[workerGroup.name]
    string
    Filter Punch Clock Records by worker group, providing the worker group name
    filter[section.id]
    int
    Filter Punch Clock Records by section, providing the section id
    filter[section.name]
    string
    Filter Punch Clock Records by section, providing the section name
    filter[type]
    Filter Punch Clock Records by type Possible values: IN, OUT
    filter[delay]
    string
    Filter Punch Clock Records by delay. Supports operational filters (eq, gt, gte, lt, lte).
    limit
    int
    Maximum number of results returned. Defaults to 25.
    offset
    int
    Page offset. Default value is 0.
    sort
    string
    Comma separated fields to sort items by. Fields: id, date. Default: “date desc”.

    Response

    HTTP Status Code Summary

    200
    OK
    A list of Punch Clock Records.
    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 Punch Clock Records
    id
    int
    Unique identifier of the Punch Clock Record.
    date
    datetime: ISO 8601
    Date time of the Punch Clock Record (e.g. 2025-06-21T14:07:17Z)
    worker
    id
    int
    number
    int
    name
    string
    Max length: 255
    anyOf
    0
    1
    type
    enum:string
    Type of Punch Clock Record Possible values: IN, OUT
    combineWithShift
    boolean
    Indicates if the Punch Clock Record should be combined with the worker shift
    delay
    string
    Delay between the start/end of the shift compared with the Punch Clock Record.
    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

    A list of Punch Clock Records.

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/punch-clock-records' \
      -H 'Authorization: '
    

    Response

    {
      "results": [
        {
          "id": 382,
          "date": "2024-05-01T08:00:00Z",
          "type": "IN",
          "worker": {
            "id": 68,
            "number": 385,
            "name": "Andrew Smith"
          },
          "combineWithShift": false,
          "delay": "PT1H15M30S"
        },
        {
          "id": 383,
          "date": "2024-05-01T17:30:00Z",
          "type": "OUT",
          "worker": {
            "id": 68,
            "number": 385,
            "name": "Andrew Smith"
          },
          "combineWithShift": false,
          "delay": "PT0H15M30S"
        }
      ],
      "pagination": {
        "limit": 20,
        "offset": 0,
        "nextUrl": null
      }
    }
    
    Show More