v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Attendance

Fetch attendance entries

Fetch attendance entries (time log entries) with filters and pagination. Only fields listed in the <code>fields</code> parameter are returned. You must provide an <code>employeeId</code> filter and at least one <code>clockInDate</code> filter (using <code>from</code> and <code>to</code> operators). The maximum date range is 33 days.

<p><b>Before using this endpoint:</b></p> <ul> <li>Explore the <a href="/docs/explore-attendance-api" target="_blank">Attendance API</a> for more details on usage, rate limits, permissions, and more.</li> <li>Field IDs are prefixed with <code>/attendanceEntry/</code> (e.g. <code>/attendanceEntry/id</code>, <code>/attendanceEntry/employeeId</code>).</li> <li>Use <code>limit</code> and <code>cursor</code> for pagination; next page cursor is in <code>response_metadata.next_cursor</code>.</li> </ul>
post/attendance/entries/search

Request body

fieldsstring[] required

List of field IDs to fetch; only these fields are returned. You must specify which field IDs to include (e.g. /attendanceEntry/id, /attendanceEntry/clockInTime). Omit a field ID to exclude it from the response. Field IDs are prefixed with /attendanceEntry/.

limitinteger

Maximum number of items per page. Default 50.

cursorstring

Opaque cursor for the next page. Use value from response_metadata.next_cursor. Omit on first request.

includeHumanReadableboolean

Whether to include human-readable values in the response

Example request

{
  "fields": [
    "/attendanceEntry/id",
    "/attendanceEntry/employeeId",
    "/attendanceEntry/clockInDate",
    "/attendanceEntry/clockOutDate",
    "/attendanceEntry/type",
    "/attendanceEntry/clockInTime",
    "/attendanceEntry/clockOutTime",
    "/attendanceEntry/duration",
    "/attendanceEntry/reasonCode",
    "/attendanceEntry/notes",
    "/attendanceEntry/projectId",
    "/attendanceEntry/taskId"
  ],
  "filters": [
    {
      "fieldId": "/attendanceEntry/employeeId",
      "operator": "equals",
      "values": [
        "3308236575481004065"
      ]
    },
    {
      "fieldId": "/attendanceEntry/clockInDate",
      "operator": "from",
      "values": [
        "2026-01-01"
      ]
    },
    {
      "fieldId": "/attendanceEntry/clockInDate",
      "operator": "to",
      "values": [
        "2026-01-30"
      ]
    }
  ]
}

Response

Attendance entries matching the search criteria

Example response

{
  "items": [
    {
      "fields": {
        "/attendanceEntry/clockInTime": {
          "value": "2026-01-26T09:00:00"
        },
        "/attendanceEntry/clockOutTime": {
          "value": "2026-01-26T17:30:00"
        }
      }
    }
  ]
}