List the holidays of persons.

  • This endpoint returns the holidays that apply to the given persons within a date range: one entry per
    person and date, from the holiday calendars assigned to each person (through their office or the
    company) on that date.
  • The person.id, date.gte and date.lte filters are required, except with cursor, which carries
    them to the next pages: recurring holidays have no end, so the date range bounds the result. It can
    start at most 2 years ago and end at most 1 year from today. Up to 50 persons per request. Filters are
    combined using the logical "AND" operator.
  • Results are grouped by person: sorted by person, then by date.
  • It supports cursor-based pagination.
  • This endpoint requires the personio:absences:read scope.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 100
Defaults to 100

The maximum number of holidays returned per request.

string

The pagination cursor to navigate over to the next list of resources. If you pass a specific limit to your request, or you rely on the default value of the number of resources to be returned, then your subsequent call has to include the cursor in order to retrieve the next list of resources. If cursor is missing, the first page is returned.

person.id
array of strings
length ≤ 50

Filter results matching any of the provided persons' ids. Repeat the parameter for several persons, for example person.id=123&person.id=456. Up to 50 ids. Required unless cursor is given.

person.id
date

Matches holidays on or after (inclusive) the provided date, at most 2 years ago. Required unless cursor is given.

date

Matches holidays on or before (inclusive) the provided date, at most 1 year from today. Required unless cursor is given.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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