> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio

> Personio REST API access for reading employees, time-off (absences), and attendance for a connected Personio company.

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](https://developer.personio.de) for full documentation.

<Warning>This provider requires your own credentials — connect your API key or OAuth account before use.</Warning>

<Info>This is a **catch-all provider** — any valid URL under `https://api.personio.de` is supported. Personio REST API. Base [https://api.personio.de](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.</Info>

## 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

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.personio.de/v1/company/employees?limit=50&offset=0', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.personio.de%2Fv1%2Fcompany%2Femployees%3Flimit%3D50%26offset%3D0" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get a single employee by id.

**GET** `https://api.personio.de/v1/company/employees/{employee_id}` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.personio.de/v1/company/employees/{employee_id}', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.personio.de%2Fv1%2Fcompany%2Femployees%2F%7Bemployee_id%7D" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### 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

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    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' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.personio.de%2Fv1%2Fcompany%2Ftime-offs%3Fstart_date%3D2026-01-01%26end_date%3D2026-12-31" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### 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

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.personio.de/v1/company/employees/attributes', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.personio.de%2Fv1%2Fcompany%2Femployees%2Fattributes" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>