Time off
One request
GET
A request you can see: yours, or one you approve.
bearerheader
AuthorizationBearer <token>An access token from /v1/auth/token, or a personal token: opaque, beginning s2a_.
workspace_id*stringwsp_…, from GET /v1/me
Length
length <= 40request_id*stringLength
length <= 40The request
application/json- response
The request
id*stringreq_…
leave_type*stringIts name, or "Away" when private and not yours
leave_type_id*string|nullstatus*stringValue in
"pending""approved""declined""cancelled"start_date*stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datestart_portion*stringValue in
"morning""afternoon"end_date*|nullend_portion*stringValue in
"lunchtime""end_of_day"open_ended*booleandates*stringThe dates in words, in the reader’s language
minutes*integerWhat it takes from the allowance
Range
-9007199254740991 <= value <= 9007199254740991day_minutes*integerRange
-9007199254740991 <= value <= 9007199254740991created_at*stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Format
date-timeweb_url*stringcurl -X GET 'https://api.sign2approve.com/v1/workspaces/string/timeoff/requests/string'{ "id": "req_01a16d3fd3507be78e41c4540aa20a3c", "leave_type": "Holiday", "leave_type_id": "lvt_01a16d3fd3507be78e41c4540aa20a3c", "status": "pending", "start_date": "2026-11-09", "start_portion": "morning", "end_date": "2026-11-13", "end_portion": "end_of_day", "open_ended": false, "dates": "Mon 9 to Fri 13 November 2026", "minutes": 2250, "day_minutes": 450, "created_at": "2026-10-24T09:30:00Z", "web_url": "https://app.example.test/w/larkspur/time-off/requests/01a16d3f-d350-7be7-8e41-c4540aa20a3c"}