# /alerts/silences - List active+pending silences (hierarchy-wide)

**GET /alerts/silences**

Cross-system parallel of `GET /systems/{id}/alerts/silences`. Returns
every active or pending Alertmanager silence in the caller's scope,
enriched with `organization_id` (the tenant that owns the silence) and
`system_key` (extracted from the silence matchers). Expired silences
and silences without a `system_key` matcher are excluded — only
silences our UI ever creates are addressable.

Scope follows the same three modes as `/alerts/totals`:
- `organization_id` omitted → caller's full hierarchy (cross-tenant fan-out).
- `organization_id=X` → single tenant `X`.
- `organization_id=X&include=descendants` → `X` plus its sub-tree.

Requires `read:systems` permission.



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## Authentication methods
- Bearer auth


## Parameters


### Query parameters
- **organization_id** (array[string])
  Target organization ID(s). Repeat the param for multiple values.
  Optional for all roles except Customer (where it is ignored).
- **include** (string)
  Set to `descendants` together with `organization_id` to expand each value to its sub-tree.
- **system_key** (array[string])
  Filter silences by one or more system keys (exact match on the
  `system_key` matcher). Repeat the param for multiple values.


## Responses
### 200
Paginated list of system-scoped silences

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 500
Internal server error

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)