v1

latestOpenAPI 3.0.02026-07-14132334.4 KB

This endpoint is responsible for fetching absence data for the company employees. It is possible to paginate results, filter by period and/or specific employees. The result will contain a list of absence periods, structured as defined here.

get/company/time-offs

Query parameters

start_datestring date

First day of the period to be queried. It is inclusive, so the day specified as start_date will also be considered on the results

end_datestring date

Last day of the period to be queried. It is inclusive, so the day specified as end_date will also be considered on the results.

updated_fromstring datetime

Datetime from when the queried periods have been updated. It is inclusive, so the day specified as updated_from will also be considered on the results.

updated_tostring datetime

Datetime until when the queried periods have been updated. It is inclusive, so the day specified as updated_to will also be considered on the results.

employeesinteger[]

A list of Personio employee identifiers to filter the results. Only those employees specified here will be returned.

limitinteger

Pagination attribute to limit how many attendances will be returned per page

offsetinteger

Pagination attribute to identify which page you are requesting, by the form of telling an offset from the first record that would be returned.

Response

successboolean required