Skip to content
Developers

Policy status

Reads the current lifecycle state of a sandbox policy issued in the same session.

GET/api/sandbox/policy/{policy_ref}/status

Reads the current lifecycle state of a sandbox policy issued in the same session.

Request fields for Policy status
FieldTypeRequiredNotes
policy_refpath parameterYesReference returned by policy issuance.

Request

GET /api/sandbox/policy/pol_sbx_9f42kq/status

Response

{
  "ok": true,
  "mode": "uat_gateway",
  "request_id": "req_71c0a934",
  "data": {
    "policy_ref": "pol_sbx_9f42kq",
    "status": "active",
    "lifecycle": [{ "state": "issued", "at": "2026-11-01T10:02:19Z" }]
  },
  "meta": { "sandbox": true }
}
  • References created in another session return not_found — sandbox data is never shared across sessions.
  • Lifecycle states: processing, issued, active, endorsed, cancelled, failed.