Get an employee
One employee profile with the fields your role may read.
GET https://cotlet.dev/api/v1/personio/employees/{employee_id}
read
Returns the Personal Info fields of one profile that your role may read, such as name, work email, team, position, supervisor and employment dates. Fields hidden from your role, for example salary without the right permission, are left out, not blanked. The result is the same data the profile page shows you.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from list_employees. |
Request
curl https://cotlet.dev/api/v1/personio/employees/employee_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("personio", "get_employee", {"employee_id":"employee_8c41d2"})const result = await cotlet.call('personio', 'get_employee', {"employee_id":"employee_8c41d2"});cotlet call personio get_employee --data '{"employee_id":"employee_8c41d2"}'Example response
{
"employee_id": "emp_2041",
"name": "Maja Kowalska",
"email": "maja.kowalska@example.com",
"team": "Marketing",
"position": "Content Lead",
"supervisor": "Tom Becker",
"employment_start": "2024-03-01",
"weekly_hours": 40
}