API Reference
Become a Partner

List Absence Periods

get
https://api.personio.de/v1/company/absence-periods

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date

When both start_date and end_date values are provided, the list of absences returned is a set that has all absences that intersects the window expressed as [start_date, end_date]. When either value is unspecified, the list of absences returned are unbounded in the direction of the unspecified value.

date

When both start_date and end_date values are provided, the list of absences returned is a set that has all absences that intersects the window expressed as [start_date, end_date]. When either value is unspecified, the list of absences returned are unbounded in the direction of the unspecified value.

date-time

Filter by periods that were 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.

date-time

Filter by periods that were 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[]
absence_types[]
array of strings

A list of Personio absence type IDs to filter the results. The result filters including only absences of provided absence types.

absence_types[]
absence_periods[]
array of strings

A list of Personio absence period IDs to filter the results. The result filters including only absences containing the provided ids.

absence_periods[]
integer
≥ 1
Defaults to 200

Pagination attribute to limit how many absence periods are returned per page.

integer
≥ 0
Defaults to 0

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

Headers
string

The partner identifier

string

The application identifier

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 7 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
problem+json

Updated 7 months ago