Approvals

Approvals waiting for you

GET
/v1/workspaces/{workspace_id}/approvals

Documents to approve and time off to decide, yours and (with tab=team) those waiting on the people below you, as the Inbox shows them.

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

Query Parameters

tab?string
Default"for_me"
Value in"for_me""team"

Response Body

What waits for your decision, oldest first

application/json
  1. response

What waits for your decision, oldest first

data*array<>
curl -X GET 'https://api.sign2approve.com/v1/workspaces/string/approvals'
{  "data": [    {      "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"    }  ]}