Check decision status

GET/v1/decisions/{decision_id}/status

Read the authorization status of a decision belonging to the connection’s agent. Use the same agent key that requested the decision.

curl "https://app.actera.dev/v1/decisions/$DECISION_ID/status" \
  --header "Authorization: Bearer $ACTERA_API_KEY"

const status = await agent.getDecisionStatus(decisionId)

Response

Returns 200 OK with a small status object:

{
  "id": "8a841842-99b2-4c10-8df1-9012e3d45678",
  "agent_id": "agent-from-connection-setup",
  "action_type": "refund.create",
  "idempotency_key": "refund-request-01842",
  "status": "PENDING_APPROVAL"
}

Status	Interpretation
RECEIVED	No resolved authority result yet.
ALLOWED	The original evaluation allowed the action.
BLOCKED	The action was blocked.
PENDING_APPROVAL	Wait for an eligible reviewer.
APPROVED	The requested exception was approved.
REJECTED	The reviewer rejected the request.
MONITORED	A Monitoring decision, not an enforcement approval.

This endpoint reports authorization state, not provider completion. For managed calls, resume the saved handle through the SDK, which also checks execution eligibility. Do not dispatch directly merely because a status says Approved.

Use bounded polling while waiting. An invalid ID returns 400; a missing decision or one outside the agent’s scope returns 404. Temporary failures can be retried without changing the decision.

Use Decisions for the full investigation view.