Skip to main content
Personio REST API access for reading employees, time-off (absences), and attendance for a connected Personio company. Use when an agent needs employee records or absence data from Personio. Routes through Pipedream Connect, so Lava holds no Personio token. 4 example endpoints available through Lava’s AI Gateway. See the Personio API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
This is a catch-all provider — any valid URL under https://api.personio.de is supported. Personio REST API. Base https://api.personio.de. v1 reads: /v1/company/employees (list), /v1/company/employees/{employee_id} (one), /v1/company/time-offs (absences, filter by start_date/end_date/employees[]), /v1/company/employees/attributes (the readable attribute schema, including custom fields). v1 pagination is limit and offset. A newer v2 API also exists (e.g. /v2/persons and /v2/absence-periods with cursor pagination), and v1 attendances are deprecated in favor of /v2/attendances. v1 employee reads only return attributes whitelisted on the connection (empty values are a whitelist gap, not an auth error). Auth is brokered by Pipedream, do not send an Authorization header. This provider is read-only: only GET requests are supported. The endpoints below are curated examples.

​
Endpoints

​
List employees. Paginate with limit and offset. Returned attributes must be whitelisted on the connection.

GET https://api.personio.de/v1/company/employees?limit=50&offset=0 — Free 
const data = await lava.gateway('https://api.personio.de/v1/company/employees?limit=50&offset=0', { method: 'GET' });

​
Get a single employee by id.

GET https://api.personio.de/v1/company/employees/{employee_id} — Free 
const data = await lava.gateway('https://api.personio.de/v1/company/employees/{employee_id}', { method: 'GET' });

​
List absences / time-off periods. Filter with start_date, end_date, and employees[].

GET https://api.personio.de/v1/company/time-offs?start_date=2026-01-01&end_date=2026-12-31 — Free 
const data = await lava.gateway('https://api.personio.de/v1/company/time-offs?start_date=2026-01-01&end_date=2026-12-31', { method: 'GET' });

​
List the readable employee attribute schema (including custom attributes). Use to discover field keys before reading employees.

GET https://api.personio.de/v1/company/employees/attributes — Free 
const data = await lava.gateway('https://api.personio.de/v1/company/employees/attributes', { method: 'GET' });

​
Next Steps

All Providers

Browse all supported AI providers

Forward Proxy

Learn how to construct proxy URLs and authenticate requests