GET
/
hris
/
absences
curl --request GET \
  --url https://api.kombo.dev/v1/hris/absences \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "22st2Ji8XpncEYEak8mvQgQF",
        "remote_id": "1348",
        "employee_id": "JDdUy9kiH5APaGizFrgNmQjM",
        "approver_id": "AgXEispYPP1BbToHpqnqcpxy",
        "start_date": "2022-08-04",
        "end_date": "2022-08-05",
        "start_half_day": true,
        "end_half_day": false,
        "start_time": "13:15:00",
        "end_time": "17:00:00",
        "amount": 2,
        "unit": "DAYS",
        "status": "APPROVED",
        "employee_note": "Visiting my family.",
        "type_id": "xzZoKssDaMZAd62kxayzzQvD",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": "2022-08-07T14:01:29.196Z",
        "remote_data": null,
        "type": {
          "id": "xzZoKssDaMZAd62kxayzzQvD",
          "remote_id": "91",
          "name": "Vacation",
          "unit": "DAYS",
          "half_days_supported": true,
          "exact_times_supported": false,
          "remote_data": null,
          "changed_at": "2022-08-07T14:01:29.196Z",
          "remote_deleted_at": null
        }
      }
    ]
  }
}

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.

​
date_from
string

Filter for all the absences that either start or haven't ended yet on/after this day. If you imagine a calendar displaying absences, this defines the left-most visible day. This is a plain date (i.e., yyyy-MM-dd), all time information is discarded.

​
date_until
string

Filter for absences that start on or before this day (but might continue after). If you imagine a calendar displaying absences, this defines the right-most visible day. This is a plain date (i.e., yyyy-MM-dd), all time information is discarded.

​
type_ids
string

Filter by a comma-separated list of absence type IDs.

​
employee_id
string

Filter by a specific employee using their ID.

​
time_from
string
deprecated

(⚠️ Deprecated - Use the date_from filter instead.) Filter for absences that either start after or start before and end after a certain time.

​
time_until
string
deprecated

(⚠️ Deprecated - Use the date_until filter instead.) Filter for absences that start before a certain time.

Response

200
application/json

GET /hris/absences Positive response

The response is of type object.

GET
/
hris
/
absences
curl --request GET \
  --url https://api.kombo.dev/v1/hris/absences \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "22st2Ji8XpncEYEak8mvQgQF",
        "remote_id": "1348",
        "employee_id": "JDdUy9kiH5APaGizFrgNmQjM",
        "approver_id": "AgXEispYPP1BbToHpqnqcpxy",
        "start_date": "2022-08-04",
        "end_date": "2022-08-05",
        "start_half_day": true,
        "end_half_day": false,
        "start_time": "13:15:00",
        "end_time": "17:00:00",
        "amount": 2,
        "unit": "DAYS",
        "status": "APPROVED",
        "employee_note": "Visiting my family.",
        "type_id": "xzZoKssDaMZAd62kxayzzQvD",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": "2022-08-07T14:01:29.196Z",
        "remote_data": null,
        "type": {
          "id": "xzZoKssDaMZAd62kxayzzQvD",
          "remote_id": "91",
          "name": "Vacation",
          "unit": "DAYS",
          "half_days_supported": true,
          "exact_times_supported": false,
          "remote_data": null,
          "changed_at": "2022-08-07T14:01:29.196Z",
          "remote_deleted_at": null
        }
      }
    ]
  }
}

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.

​
date_from
string

Filter for all the absences that either start or haven't ended yet on/after this day. If you imagine a calendar displaying absences, this defines the left-most visible day. This is a plain date (i.e., yyyy-MM-dd), all time information is discarded.

​
date_until
string

Filter for absences that start on or before this day (but might continue after). If you imagine a calendar displaying absences, this defines the right-most visible day. This is a plain date (i.e., yyyy-MM-dd), all time information is discarded.

​
type_ids
string

Filter by a comma-separated list of absence type IDs.

​
employee_id
string

Filter by a specific employee using their ID.

​
time_from
string
deprecated

(⚠️ Deprecated - Use the date_from filter instead.) Filter for absences that either start after or start before and end after a certain time.

​
time_until
string
deprecated

(⚠️ Deprecated - Use the date_until filter instead.) Filter for absences that start before a certain time.

Response

200
application/json

GET /hris/absences Positive response

The response is of type object.