# Get alert history trend

**GET /alerts/trend**

Returns trend data for resolved alerts over a specified period with daily data points.
Compares the current period with the previous period of equal length.
Requires `read:systems` permission.

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

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 aggregate over the target org's full sub-tree.
- **period** (integer)
  Trend period in days


## Responses
### 200
Alert trend data

#### 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)