---
title: "List Monitors"
method: GET
path: "/api/v1/monitor/monitors"
tags: ["Monitors"]
---

# List Monitors

`GET /api/v1/monitor/monitors`

This endpoint allows you to retrieve a list of all the monitors in your workspace.

## Response `200`

List of Monitors.

- object
  - `links` object — Indicates Links to associated pages.
    - `next` string — The link to the next page (null if there are no more pages).
    - `previous` string — The link to the previous page (null if on the first page).
  - `meta` object — Reprents the meta data of the response.
    - `page` integer — The current page number.
    - `previous_page` integer — The previous page number (null if on the first page).
    - `next_page` integer — The next page number (null if on the last page).
  - `count` integer — The total count of items returned.
  - `total_pages` integer — The total number of pages.
  - `results` V1MonitorResponse[]
    - `id` string — The unique identifier of the monitor.
    - `created_at` string — The timestamp when the monitor was created.
    - `updated_at` string — The timestamp when the data was last updated.
    - `integration` string — The identifier of the integration associated with the resource.
    - `target` string — The identifier of the resource that the monitor is watching.
    - `workspace` string — The identifier of the workspace.
    - `metric_type` 'row_count' | 'cardinality' | 'mean' | 'max' | 'min' | 'unique_percentage' | 'null_percentage' | 'freshness' | 'custom_sql' — The type of metric.
    - `metric_config` string — Configuration for the metric.
    - `frequency` integer — The frequency with which this monitor is run.
    - `name` string — The full name of the monitor, includes the metric type and target resource.
    - `is_enabled` boolean — Whether the monitor is enabled.
    - `last_attempted_at` string — The timestamp of the last attempted monitor.
    - `last_success_at` string, date-time — The timestamp of the last check on Secoda's access and ability to read the data source on which this monitor is set. This is connctivity check - not a data quality check.
    - `last_error_at` string — The timestamp of the last error, if any.
    - `last_error_message` string — The message associated with the last error, if any.
    - `condition_auto_sensitivity` integer — The automatic sensitivity condition.
    - `condition_manual_min` integer — The manual minimum condition if set by the user.
    - `condition_manual_max` integer — The manual maximum condition if set by the user.
    - `status` 'normal' | 'incident' | 'error' | 'learning' | 'inactive' — The status of the monitor.
    - `display_metadata` object — This is an internally used object that provides additional information about the incident. This can be ignored by customers.
      - `target` object
        - `icon` string — Icon associated with the target resource, if one exists.
        - `label` string — Title of the target resource.
        - `entity_type` string — The type of the target resource (e.g., column).
        - `integration` string — The UUID of the integration from which the target resource is extracted.
        - `integration_type` string — The type of integration.
    - `last_measurement_value` number — The last measured value if one is available.
    - `last_incident` string — The UUID of the last active incident. If there are no active incidents (if the last incident has been closed), the field is set to null.
    - `last_measurement` string — The identifier of the last measurement.
    - `next_run_at` string — The timestamp for the next run. Note, the run may occur shortly after the time set, but never before.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/secoda/apis/secoda-api.md) · [All operations](https://skmtc.dev/secoda/apis/secoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/secoda/secoda-api/revisions/e6d760bd7a94/schema)