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