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

# List monitoring alerts

`GET /monitoring/alerts`

## Query parameters

- `id` string[]
- `sanctions_screening_id` string[]
- `monitoring_event_id` string[]
- `business_id` string[]
- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get
- `person_id` string[]
- `limit` integer — Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

## Response `200`

List of alerts.

- MonitoringAlertList
  - `alerts` MonitoringAlert[], required
    - `business_id` string, uuid — Unique ID for the business. Exactly one of `business_id` or `person_id` must be set.
    - `creation_time` string, date-time — The date and time the resource was created.
    - `id` string, uuid — Unique identifier for this alert.
    - `last_updated_time` string, date-time — The date and time the resource was last update.
    - `metadata` Metadata — Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.
    - `monitoring_event_id` string, uuid — Unique identifier for the monitoring event that produced this alert.
    - `person_id` string, uuid — Unique ID for the person. Exactly one of `person_id` or `business_id` must be set.
    - `status` 'ACTIVE' | 'SUPPRESSED' — The status of the alert. Any of the following: * `ACTIVE` – alert has been issued and should be investigated. * `SUPPRESSED` – alert is a false positive, alert should be dismissed, or has been otherwise investigated.
    - `title` string — A description of the monitoring alert.
    - `type` 'BANKRUPTCY' | 'LICENSE_VALIDITY' | 'NEGATIVE_NEWS' | 'WATCHLIST' — The type of customer alert. Any of the following: * `WATCHLIST` – the customer was added to a known watchlist. * `BANKRUPTCY` – the customer filed for bankruptcy. * `NEGATIVE_NEWS` – the customer was mentioned in negative news articles. * `LICENSE_VALIDITY` – the license is no longer valid. Exmaple of this would be if a license was suspended
    - `urls` string[] — Where to get more information about this alert.
    - `vendor_info` union — The information provided to Synctera from the vendor. Interpretation of this object is up to the client.
      - object
        - `content_type` 'application/json', required — Describes the content-type encoding received from the vendor
        - `json` object, required — Data representation in JSON
        - `vendor` string, required
      - object
        - `content_type` 'text/xml', required — Describes the content-type encoding received from the vendor
        - `vendor` string, required
        - `xml` string, required — Data representaion in XML
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)