List monitors

GET/v1/monitors

Send your API key as Authorization: Bearer. See Authentication. How each option works: Monitors.

Query parameter

limitintegerdefault 501 to 200

How many monitors to return, newest first: at most 200.

cursorstring

The next_cursor of the page before. Leave it out for the first page.

Response

200

monitors[]object[]

Your monitors, newest first. Each one is a monitor object.

next_cursorstring or null

Send it as cursor to get the next page. null on the last page.

Errors

Status	Code	When
401	unauthorized	The API key is missing or not valid.
403		The API key has no access to monitors.
429	rate_limited	Your key went over its requests-per-minute cap, or Telem is busy. Wait for the seconds in Retry-After, then try again.
503	unavailable	Telem cannot run monitors now. Try again later.

What each error means and what to do: Errors.

Request

cURL

curl -X GET "https://router.telem.ai/v1/monitors?limit=50" \
  -H "Authorization: Bearer $TELEM_API_KEY"

Python

monitors = client.monitors.list(limit=50)

JavaScript

const monitors = await telem.monitors.list({ limit: 50 })

Response

200

{
  "monitors": [
    {
      "id": "6f1c2a4e-3b7d-4c51-9e0a-8d2f6b1c7a90",
      "query": "Nvidia files a new 8-K with the SEC",
      "frequency": "1h",
      "status": "active",
      "session_id": "a2d9e1f0-5c3b-4a7d-8e6f-1b2c3d4e5f60",
      "created_at": "2026-10-11T09:00:00Z",
      "last_polled_at": null,
      "expires_at": "2026-10-18T09:00:00Z",
      "webhook_url": null,
      "webhook_secret": null,
      "agent_note": null
    }
  ],
  "next_cursor": null
}

An example built from the response schema.

401

{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key"
  }
}

A real response.