List Time-Offs

get

https://api.personio.de/v1/company/time-offs

Fetches absence periods for absences with time unit set to days. The result can be paginated and filtered by period and/or specific employee/employees. The result contains a list of absence periods.

Query Params

start_date

date

First day of the period to be queried. It is inclusive, so the result starts from and including the provided start_date

end_date

date

Last day of the period to be queried. It is inclusive, so the result ends on end_date including absences from the end_date

updated_from

date

Query the periods that created or modified from the date updated_from. It is inclusive, so all the periods created or modified from the beginning of the updated_from will be included in the results

updated_to

date

Query the periods that created or modified until the date updated_to. It is inclusive, so all the periods created or modified until the end of the updated_to will be included in the results

employees[]

array of integers

A list of Personio employee ID's to filter the results. The result filters including only absences of provided employees

employees[]

limit

integer

≥ 1

Defaults to 200

Pagination attribute to limit the number of absence periods per page

offset

integer

≥ 0

Defaults to 0

Pagination attribute to identify which page number you are requesting

Headers

X-Personio-Partner-ID

string

The partner identifier

X-Personio-App-ID

string

The application identifier

Response

Language

Credentials

Bearer

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json