GET
/
hris
/
timesheets
curl --request GET \
  --url https://api.kombo.dev/v1/hris/timesheets \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "C1BB1C36-FE1D-4185-AAB8-0716D8FBA017",
        "remote_id": "446655440000",
        "employee_id": "289AD550-8659-4305-92B2-6EAA006AAB17",
        "started_at": "2025-04-16T09:02:00.000Z",
        "ended_at": "2025-04-16T16:59:00.000Z",
        "payable_hours": 8,
        "unpaid_break_minutes": 30,
        "breaks": [
          {
            "ended_at": "2025-04-16T12:30:00.000Z",
            "paid": false,
            "started_at": "2025-04-16T12:00:00.000Z"
          }
        ],
        "approval_status": "APPROVED",
        "approved_at": "2025-04-16T15:05:31.000Z",
        "comment": "Sprint planning & code review",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "remote_data": {}
      }
    ]
  }
}

Retrieve attendance data and timesheets from HRIS tools.

Closed Beta: This API is currently in closed beta and still in development. Its features and functionality are subject to change as we continue to refine and improve the product. If you want to have access, please reach out to support.

Top level filters use AND, while individual filters use OR if they accept multiple arguments. That means filters will be resolved like this: (id IN ids) AND (remote_id IN remote_ids)

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Query Parameters

​
cursor
string

An optional cursor string used for pagination. This can be retrieved from the next property of the previous page response.

​
page_size
integer
default:100

The number of results to return per page. Maximum is 250.

Required range: 1 <= x <= 250
​
updated_after
string

Filter the entries based on the modification date in format YYYY-MM-DDTHH:mm:ss.sssZ. If you want to track entry deletion, also set the include_deleted=true query parameter, because otherwise, deleted entries will be hidden.

​
include_deleted
enum<string>
default:false

By default, deleted entries are not returned. Use the include_deleted query param to include deleted entries too.

Available options:
true,
false
​
ids
string

Filter by a comma-separated list of IDs such as 222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3.

​
remote_ids
string

Filter by a comma-separated list of remote IDs.

​
employee_id
string

Returns timesheets for a specific employee.

​
started_before
string

Return timesheets whose start time is before the given timestamp.

​
started_after
string

Return timesheets whose start time is on or after the given timestamp.

​
ended_before
string

Return timesheets whose end time is on or before the given timestamp.

​
ended_after
string

Return timesheets whose end time is on or after the given timestamp.

Response

200
application/json

GET /hris/timesheets Successful response

The response is of type object.