Approvals
One approval
GET
One item waiting for your decision.
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 <= 40approval_id*stringLength
length <= 40The approval
application/json- response
The approval
id*stringenv_… for a document, req_… for time off
module*stringValue in
"documents""timeoff"title*stringdetail*stringwho*stringWho sent or asked for it
since*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-timeassignment*stringValue in
"personal""pooled""oversight"can_act*booleanactions*array<>What you may do with it here
web_url*stringcurl -X GET 'https://api.sign2approve.com/v1/workspaces/string/approvals/string'{ "id": "req_01a16d3fd3507be78e41c4540aa20a3c", "module": "timeoff", "title": "Annual leave, 3 to 5 November", "detail": "Sales · takes 3 days · 12 days left after", "who": "Sam Sender", "since": "2026-10-24T09:30:00Z", "assignment": "personal", "can_act": true, "actions": [ "approve", "decline" ], "web_url": "https://app.example.test/w/larkspur/inbox#request=01a16d3f-d350-7be7-8e41-c4540aa20a3c"}