Get a time off allowance
Allowance, days used, pending and remaining for one person and leave year, with adjustments.
GET https://cotlet.dev/api/v1/charliehr/members/{member_id}/time-off-allowance
read
Returns the numbers shown under the person's holiday allowance on the Time tab, for the current leave year or the one you name. Hourly workers get hours instead of days. Adjustments list their type, amount, note and expiry date. Remaining is allowance minus used minus pending.
Parameters
| Name | Type | Description |
|---|---|---|
| member_id string required | string | Id from list_team_members |
| leave_year string | string | Leave year as shown in Charlie, for example 2026; defaults to the current one |
Request
curl https://cotlet.dev/api/v1/charliehr/members/member_8c41d2/time-off-allowance \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("charliehr", "get_time_off_allowance", {"member_id":"member_8c41d2"})const result = await cotlet.call('charliehr', 'get_time_off_allowance', {"member_id":"member_8c41d2"});cotlet call charliehr get_time_off_allowance --data '{"member_id":"member_8c41d2"}'Example response
{
"member_id": "tm_52e1a9",
"name": "Sam Rivera",
"leave_year": "2026",
"unit": "days",
"allowance": 25,
"used": 5,
"pending": 3,
"remaining": 17,
"adjustments": [
{
"adjustment_id": "adj_20c8",
"direction": "increase",
"amount": 1,
"type": "Length of service",
"expires_on": null,
"notes": "Third year"
}
]
}