# Org-level paginated alert history

**GET /alerts/history**

Returns paginated resolved alert history scoped to the caller's hierarchy
(no `organization_id`), a single tenant (`organization_id=X`), or a sub-tree
(`organization_id=X&include=descendants`). Mirrors the scope rules of
`/alerts/totals` and `/alerts/trend`.

Supports date range (`from_date`/`to_date`, RFC3339) and multi-value label
filters (`alertname`, `severity`, `status`). All multi-value filters: OR within
the same filter, AND across filters.

Customer callers are always pinned to their own organization regardless of params.



## 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** (string)
  Target organization ID. Optional for all roles except Customer (where it is ignored).
- **include** (string)
  Set to `descendants` together with `organization_id` to drill down on a sub-tree.
- **page** (integer)
  Page number
- **page_size** (integer)
  Items per page
- **sort_by** (string)

- **sort_direction** (string)
  Sort direction
- **from_date** (string(date-time))
  Lower bound on `created_at` (inclusive). RFC3339 timestamp.
- **to_date** (string(date-time))
  Upper bound on `created_at` (exclusive). RFC3339 timestamp. Must be after `from_date`.
- **alertname** (array[string])
  Filter by alertname. Supports multiple values.
- **severity** (array[string])
  Filter by severity. Supports multiple values.
- **status** (array[string])
  Filter by status. Supports multiple values.


## Responses
### 200
Paginated alert history

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

- **message** (string)

- **data** (object)


### 400
Bad request - validation error

#### Body: application/json (object)
- **code** (integer)
  HTTP error code
- **message** (string)
  Error message
- **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)



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