List Attendances

get https://api.personio.de/v1/company/attendances

Fetch attendance data for the company employees. The result can be paginated and filtered by period, the date and/or time they were updated, and/or specific employee/employees. The result contains a list of attendances.

Query Params

start_date

date

required

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_date

date

required

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_from

string

Datetime from when the queried periods have been updated. Same format as updated_at. It is inclusive, so the day specified as updated_from will also be considered on the results. Can be just the date, or the date and the time, with or without the timezone.

updated_to

string

Datetime until when the queried periods have been updated. Same format as updated_at. It is inclusive, so the day specified as updated_to will also be considered on the results. Can be just the date, or the date and the time, with or without the timezone.

includePending

boolean

Returns AttendancePeriods with a status of pending, rejected and confirmed. For pending periods, the end_date attribute is nullable. The status of each period is included in the response.

employees[]

array of integers

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

employees[]

limit

integer

≥ 1

Defaults to 200

Pagination attribute to limit how many attendances are per page

offset

integer

≥ 0

Defaults to 0

The offset from the first record that would be returned. With 3 results [A, B, C] and an offset of 1, the following two results will be returned [B, C].

Headers

X-Personio-Partner-ID

string

The partner identifier

X-Personio-App-ID

string

The application identifier

Responses

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.personio.de/v1/company/attendances?limit=200&offset=0' \
3
     --header 'accept: application/json'

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

application/json

200The Attendance periods matching the provided filters

401Unauthorized Access

403Forbidden Access