Get one person's calendar
A year of one person's bookings with leave taken and remaining.
GET https://cotlet.dev/api/v1/timetastic/employee-calendar
read
Returns the bookings of that year with leave type and status, and the summary Timetastic shows beside the Calendar: annual leave taken, annual leave remaining and total non-deductible leave. Managers and admins can open an employee's Calendar for their leave summary.
Parameters
| Name | Type | Description |
|---|---|---|
| employee string required | string | Full name of the person, as the Wallchart shows it. |
| year integer | integer | Year such as 2026. Defaults to the current year. |
Request
curl "https://cotlet.dev/api/v1/timetastic/employee-calendar?employee=employee" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("timetastic", "get_employee_calendar", {"employee":"employee"})const result = await cotlet.call('timetastic', 'get_employee_calendar', {"employee":"employee"});cotlet call timetastic get_employee_calendar --data '{"employee":"employee"}'Example response
{
"employee": "Ana Torres",
"year": 2026,
"annual_leave_taken": 18,
"annual_leave_remaining": 10,
"non_deductible_leave": 1,
"bookings": [
{
"from": "2026-09-07",
"to": "2026-09-08",
"leave_type": "Holiday",
"status": "Approved",
"days": 2
},
{
"from": "2026-09-15",
"to": "2026-09-15",
"leave_type": "Sick leave",
"status": "Approved",
"days": 1
}
]
}