List time off
Time off periods in a date window, with status, newest first.
GET https://cotlet.dev/api/v1/personio/time-offs
read
Lists time off periods that overlap the window you give, newest first. Each item has the employee, the type, the dates and a status of approved or pending. Filter by employee or team to check who is away. Pages hold up to 100 items; pass next_cursor back as cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| from string required | string | Window start, YYYY-MM-DD. |
| to string required | string | Window end, YYYY-MM-DD. |
| employee_id string | string | Only this employee. |
| team string | string | Only this team. |
| status string | string | 'approved' or 'pending'. Default both. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/personio/time-offs?from=from&to=to" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("personio", "list_time_off", {"from":"from","to":"to"})const result = await cotlet.call('personio', 'list_time_off', {"from":"from","to":"to"});cotlet call personio list_time_off --data '{"from":"from","to":"to"}'Example response
{
"time_off": [
{
"time_off_id": "to_93a1",
"employee_id": "emp_2041",
"name": "Maja Kowalska",
"time_off_type": "Vacation",
"start_date": "2026-12-24",
"end_date": "2026-12-26",
"days": 3,
"status": "approved"
}
],
"next_cursor": null
}