---
title: "List alerts"
method: GET
path: "/internal/v1/alerts/{project_id}"
tags: ["Alerts"]
---

# List alerts

`GET /internal/v1/alerts/{project_id}`

List alerts with optional filtering by status, priority, type, activity state, monitor ID, and free-text search. Returns alerts sorted by most recent event by default.

## Path parameters

- `project_id` integer, required

## Query parameters

- `search` string
- `attrs[status][]` AlertStatus[]
- `attrs[priority][]` AlertPriority[]
- `attrs[type][]` AlertType[]
- `attrs[activityState][]` AlertActivityState[]
- `attrs[monitorId][]` integer[]
- `sort_by` string
- `sort_dir` 'ASC' | 'DESC' — Sort direction.
- `limit` integer

## Response `200`

List of alerts.

- object
  - `alerts` Alert[], required
    - `id` integer, required
    - `projectId` integer, required
    - `monitorId` integer
    - `name` string, required
    - `type` 'error' | 'metric', required — Alert type.
    - `attrs` object — Custom alert attributes.
    - `event` AlertEvent — A lifecycle event on an alert.
      - `id` integer, required
      - `alertId` integer, required
      - `name` string, required — Event type: created, status_changed, state_changed, priority_changed, recurring, note, assigned.
      - `status` 'unresolved' | 'resolved' | 'archived', required — Alert resolution status.
      - `activityState` 'new' | 'ongoing' | 'escalated' | 'regressed' — Alert activity state while unresolved.
      - `priority` 'info' | 'low' | 'medium' | 'high' — Alert priority level.
      - `createdAt` integer — Unix timestamp (nanoseconds).
    - `createdAt` integer — Unix timestamp (nanoseconds).
    - `updatedAt` integer — Unix timestamp (nanoseconds).
  - `count` integer, required — Total number of matching alerts.

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/uptrace/apis/uptrace-json-api.md) · [All operations](https://skmtc.net/uptrace/apis/uptrace-json-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptrace/uptrace-json-api/revisions/550c8881ab9a/schema)