Time off

Your balances

GET
/v1/workspaces/{workspace_id}/timeoff/balances

What you have left in each allowance, this leave year and next, in minutes (divide by day_minutes for days).

Authorization

bearer
headerAuthorizationBearer <token>

An access token from /v1/auth/token, or a personal token: opaque, beginning s2a_.

Path Parameters

workspace_id*string

wsp_…, from GET /v1/me

Lengthlength <= 40

Response Body

Default Response

application/json
  1. response
this_year*array<>
next_year*array<>
curl -X GET 'https://api.sign2approve.com/v1/workspaces/string/timeoff/balances'
{  "this_year": [    {      "pool": "Annual leave",      "year_start": "2026-01-01",      "year_end": "2026-12-31",      "unit": "minutes",      "day_minutes": 450,      "entitlement": 11250,      "carried_forward": 900,      "toil": 0,      "adjustments": 0,      "taken": 4500,      "pending": 450,      "balance": 7650,      "available": 7200    }  ],  "next_year": []}