Approvals

One approval

GET
/v1/workspaces/{workspace_id}/approvals/{approval_id}

One item waiting for your decision.

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
approval_id*string
Lengthlength <= 40

Response Body

The approval

application/json
  1. response

The approval

id*string

env_… for a document, req_… for time off

module*string
Value in"documents""timeoff"
title*string
detail*string
who*string

Who sent or asked for it

since*string
Match^(?:(?:\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)))$
Formatdate-time
assignment*string
Value in"personal""pooled""oversight"
can_act*boolean
actions*array<>

What you may do with it here

web_url*string
curl -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"}