List monitors
list_monitorsRead-onlyIdempotent
Search and list the team's monitors (the websites, hosts and services Oh Dear watches, also called sites) with their current up/down status, open issues and performance metrics. Pass monitor_id to fetch the full detail for one monitor. Start here when you need a monitor ID for another tool. See https://ohdear.app/docs/api/monitors.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of monitors to return (default: 50) | |
| search | No | Optional search term to filter monitors by name, URL, or tags | |
| monitor_id | No | Optional monitor ID to fetch details for a specific monitor | |
| only_with_issues | No | Only show monitors that have issues |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| monitors | Yes | The matching monitors. | |
| view_url | Yes | Oh Dear URL for the monitor list. | |
| statistics | Yes | Counts and filters applied to this monitor listing. |