---
title: "List Monitoring Alerts"
method: GET
path: "/api/v1/monitoring/alerts"
tags: ["Monitoring Alerts"]
---

# List Monitoring Alerts

`GET /api/v1/monitoring/alerts`

List all monitoring alerts.
This endpoint requires a valid API key (X-API-KEY) to be  provided in the headers and is rate limited to 5 requests
per second.

## Query parameters

- `created_before` string, date-time
- `created_after` string, date-time
- `domain` union[]
  - union
    - string
    - '[]'
- `external_ref_id` union[]
  - union
    - string
    - '[]'
- `flagged_categories` union[]
  - union
    - string
    - '[]'
- `order_by` string[]
- `limit` integer
- `offset` integer

## Response `200`

OK

- PagedMonitoringAlert
  - `alerts` MonitoringAlert[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `domain` string, required
    - `external_ref_id` string
    - `flagged_categories` FlaggedCategory[], required
      - `name` string, required
      - `description` string, required
    - `flagged_content` FlaggedContent[], required
      - `link` FlaggedPageLink, required
        - `type` 'io.truebiz.monitoring.link.page', required
        - `href` string, required
      - `content` string, required
    - `flagged_page_links` FlaggedPageLink[], required
      - `type` 'io.truebiz.monitoring.link.page', required
      - `href` string, required
    - `flagged_people` Person[], required
      - `name` string — The person's full name.
      - `job_title` string — A name that describes someone's job or position.
      - `linkedin_url` string — The person's LinkedIn profile URL.
      - `profile_picture` string — The URL of the person's LinkedIn profile photo.
      - `state_province` string — The state or province where the person is located.
      - `city` string — The city where the person is located.
      - `country` string — The country where the person is located.
      - `start_date` string, date, nullable — The date the person started at the company.
      - `other_active_positions` EmploymentRecord[], nullable — Other jobs listed as currently active.
        - `company_name` string, required — The company name.
        - `title` string — The job title.
        - `start_date` string, date — The date the person started at the job.
      - `source` 'website' | 'social' | 'other' | 'submitted' — An enumeration.
    - `ui_portal_link` UIPortalLink, required
      - `type` 'io.truebiz.link.ui-detail', required
      - `href` string, required
  - `count` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `prev_alerts_link` PrevLink
    - `id` string, uuid, required
    - `type` 'io.truebiz.link.prev-items', required
    - `href` string, required
  - `next_alerts_link` NextLink
    - `id` string, uuid, required
    - `type` 'io.truebiz.link.next-items', required
    - `href` string, required

## Other responses

- `202` — Accepted
- `204` — No Content
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api.md) · [All operations](https://skmtc.net/truebiz/apis/truebiz-web-presence-review-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truebiz/truebiz-web-presence-review-api/revisions/22a9a6d3740a/schema)