Get a monitor

GET/v1/monitors/{monitor_id}

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

Path parameter

monitor_idstring (UUID)

The ID of the monitor, from the response that created it.

Response

200

idstring (UUID)

The ID of the monitor.

querystring

What the monitor watches for.

frequencystring

How often Telem runs the query.

statusstringone of active, paused, ended

active: Telem runs the query on the schedule. paused: you paused it. ended: its end time passed, or its API key was revoked or expired, and it does not run again. A monitor that nobody polls stops its runs but still shows active: see Monitors.

session_idstring (UUID)

The session where Telem records your polls.

created_atstring (date-time)

When you created the monitor.

last_polled_atstring (date-time) or null

Your last poll or delivered webhook, or null.

expires_atstring (date-time) or null

When the monitor ends, or null without a ttl.

webhook_urlstring or null

Where Telem sends new results, or null.

webhook_secretstring or null

The secret to check webhook requests with. Only the response that sets webhook_url has it, so keep it.

agent_notestring or null

Only in the answer to a create: why the monitor agent did not start, or null. The monitor then runs without an agent.

Errors

Status	Code	When
401	unauthorized	The API key is missing or not valid.
403		The API key has no access to monitors.
404	not_found	The monitor does not exist, or another API key created it.
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/$MONITOR_ID" \
  -H "Authorization: Bearer $TELEM_API_KEY"

Python

monitor = client.monitors.get(monitor_id)

JavaScript

const monitor = await telem.monitors.get(monitorId)

Response

200

{
  "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
}

An example built from the response schema.

404

{
  "error": {
    "code": "not_found",
    "message": "Monitor not found"
  }
}

A real response.