Get employee planner
Reads one employee's holidays or absences for a date range from their Planner tab.
GET https://cotlet.dev/api/v1/peoplehr/employees/{employee_id}/planner
read
Returns each entry in the range with its dates and duration in days, in date order. Holidays include the status of the request. Anything that deducts days from the entitlement, emergency leave included, shows up under holidays.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from list_employees, for example PW15. |
| type string required | string | holidays or absences. |
| start_date string required | string | First day, YYYY-MM-DD. |
| end_date string required | string | Last day, YYYY-MM-DD. |
Request
curl "https://cotlet.dev/api/v1/peoplehr/employees/employee_8c41d2/planner?type=type&start_date=start+date&end_date=end+date" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("peoplehr", "get_employee_planner", {"employee_id":"employee_8c41d2","type":"type","start_date":"start date","end_date":"end date"})const result = await cotlet.call('peoplehr', 'get_employee_planner', {"employee_id":"employee_8c41d2","type":"type","start_date":"start date","end_date":"end date"});cotlet call peoplehr get_employee_planner --data '{"employee_id":"employee_8c41d2","type":"type","start_date":"start date","end_date":"end date"}'Example response
{
"employee_id": "PW15",
"type": "holidays",
"entries": [
{
"start_date": "2026-11-16",
"end_date": "2026-11-18",
"duration_days": 3,
"status": "Pending"
},
{
"start_date": "2026-11-26",
"end_date": "2026-11-27",
"duration_days": 2,
"status": "Approved"
}
]
}