List employees
Employees with name, team, job title, supervisor and status, newest first.
GET https://cotlet.dev/api/v1/personio/employees
read
Lists employees you may see in Personio, newest first. Filter by team, status or a name fragment. Only the attributes your role may read are returned; others come back empty. Pages hold up to 100 employees; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| team string | string | Team name as shown in Personio. |
| status string | string | 'active' (default), 'inactive' or 'onboarding'. |
| search string | string | Part of the first or last name. |
| limit integer | integer | Items per page, 1 to 100. Default 100. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/personio/employees \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("personio", "list_employees")const result = await cotlet.call('personio', 'list_employees');cotlet call personio list_employeesExample response
{
"employees": [
{
"employee_id": "emp_2041",
"name": "Maja Kowalska",
"team": "Marketing",
"position": "Content Lead",
"supervisor": "Tom Becker",
"status": "active",
"hired_at": "2024-03-01"
}
],
"next_cursor": "eyJvZmZzZXQiOjEwMH0"
}