---
title: "List escalation contacts"
method: GET
path: "/orgs/v1/{org_id}/escalation-contacts"
tags: ["Escalations"]
---

# List escalation contacts

`GET /orgs/v1/{org_id}/escalation-contacts`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/{org_id}/escalation-contacts`
- Auth: none declared

Who gets paged, at which level. Visible to org members. Auth: SIWX wallet, control-plane session, or a run402_agent_key grant key. A project service_key is REJECTED — an escalation is agent judgement and needs a principal to attribute. Deny is 403, never 404. NEVER lifecycle-gated: an org in grace is exactly when an agent may most need a human.

## Path parameters

- `org_id` string, uuid, required

## Response `200`

contacts[]

- EscalationContactList
  - `escalation_contacts` EscalationContact[]
    - `contact_id` string, uuid
    - `email` string, email
    - `display_name` string, nullable
    - `level` integer
    - `created_at` string, date-time
    - `warnings` string[]: Faithful reachability notes (e.g. no verified contact email yet).

## Other responses

- `400`: Invalid input (missing/over-cap reason, malformed email, bad level or status).
- `401`: Missing or invalid auth.
- `403`: Not authorized (never a 404 existence oracle); also rate/open-bound denials (QUOTA_EXCEEDED with used/limit) and step-up required.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)