Monitors
List monitors
List your organization’s monitors with GET /v1/monitors, newest first, filtered by status, name or metadata, with cursor pagination.
GET
List monitors
List your organization’s monitors, newest first. Every list in the Monitors API has the same shape:
You get a page of monitors in
data, has_more and next_cursor. To get the next page, pass next_cursor as cursor.
When to use it
Call it before you create a monitor, to find one on the same topic byname. Filter by status to find paused or disabled monitors, or by your own tags with metadata[key]=value. This request lists the active monitors tagged team=research:
data. If has_more is true, repeat the request with cursor set to next_cursor. To count monitors without paging, use Count monitors.
SDK, CLI and MCP
The SDK methods need SDK 0.2.0 or later. See SDKs → Monitors and Monitors tools.
Related operations
- Get a monitor returns one monitor by
id. - Bulk actions pauses, resumes or deletes the monitors that match the same kind of filter.
- Count monitors counts them by status and schedule.