Skip to main content
GET
Approval Status
Returns the current status, expiry, and token state for an approval request. This route is org- and wallet-scoped. It accepts any caller that can access the underlying approval request: static operator key, tenant API key, or authorized platform session.

Response Fields

This REST route does not return the raw approval_token. For that, use POST /v1/approvals/{approval_id}/consume or the MCP approval tools.

Approval States

Token States

Errors

  • 401 UNAUTHENTICATED / INVALID_API_KEY
  • 403 REJECTED_POLICY: caller cannot access the approval’s org or wallet
  • 404 NOT_FOUND: approval does not exist