List supervision approvals

GET/approvals

Requires scope: read:wallet

Parameters

Parameter	In	Type
`status`	query	"pending" \| "approved" \| "declined" \| "expired" \| "superseded" \| "execution_failed"
`limit`	query	integer
`cursor`	query	string

Responses

Status	Description
`200`	A bounded page of approvals
`400`	Invalid filters or cursor
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl "https://vergio.ai/api/v1/approvals?status=value&limit=25" \
  -H "Authorization: Bearer $VERGIO_API_KEY"

Response (200)

{
  "state": "string",
  "approvals": [
    {
      "id": "b7c9a2e1-0000-4000-8000-000000000000",
      "kind": "growth_report_spend",
      "store_id": "b7c9a2e1-0000-4000-8000-000000000000",
      "reason": {},
      "quoted_amount_cents": 0,
      "source_rule_id": "b7c9a2e1-0000-4000-8000-000000000000",
      "status": "pending",
      "decided_at": "2026-07-06T12:00:00Z",
      "decision_note": "string",
      "executed_action_id": "string",
      "expires_at": "2026-07-06T12:00:00Z",
      "created_at": "2026-07-06T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}