Get the latest decision

/api/v1/decisionGET

Returns the last decision and outstanding permit, each nullable. Does not issue or consume a permit.

Examples are synthetic and illustrate response shape; IDs, signatures, and credentials are not usable authority.

Authorization

serviceBearer *Bearer <token>

Scoped restricted-service session minted by trusted runtime. Cannot be used on owner routes.

Response

200 · Successful response. A paused run is an application outcome, not an HTTP error.

decision *object | null

Show options

Any of:

Option 1

decision *"ALLOW" | "PAUSE" | "TERMINATE"

reasonCode *string

explanation *string

clarificationRequest?stringnull

Default: null

Option 2

Type: null

permit *object | null

Show options

Any of:

Option 1

id *string

runId *string

turnId *string

goalId *string

action *object

Show properties

operationId *string

Min length: 1Max length: 100

targetRef?string

Max length: 200

url?string

Max length: 500

value?string

Max length: 1000

args?object

Default: {}

observationId *string

documentEpoch *number

stateRevision *number

operationId *string

protectedOperationId *stringnull

expiresAt *string

status *"issued" | "claimed" | "consumed" | "revoked"

grantId *string

transactionProposalId *stringnull

Option 2

Type: null

400 · Request validation failed.

error *string

reasonCode?string

403 · Exact service origin required.

error *string

reasonCode?string

500 · The local service could not complete this request.

error *string

reasonCode?string

Request example

curl -X GET "https://bank.example.com/api/v1/decision" \
  -H "Authorization: Bearer <token>"

Response example

{
  "decision": {
    "decision": "ALLOW",
    "reasonCode": "TASK_ALIGNED",
    "explanation": "The beneficiary read matches the approved task.",
    "clarificationRequest": null
  },
  "permit": {
    "id": "66666666-6666-4666-8666-666666666666",
    "runId": "11111111-1111-4111-8111-111111111111",
    "turnId": "77777777-7777-4777-8777-777777777777",
    "goalId": "33333333-3333-4333-8333-333333333333",
    "action": {
      "kind": "service",
      "operationId": "bank.beneficiary",
      "args": {}
    },
    "observationId": "44444444-4444-4444-8444-444444444444",
    "documentEpoch": 1,
    "stateRevision": 1,
    "operationId": "bank.beneficiary",
    "protectedOperationId": "bank.beneficiary",
    "expiresAt": "2026-10-26T12:00:30.000Z",
    "status": "issued",
    "grantId": "frozen-bank-grant",
    "transactionProposalId": null
  }
}