Skip to main content
GET
Get a monitor
Get one monitor. upcoming_runs lists its next three run times in UTC.

When to use it

Check a monitor’s status after a monitor.disabled event, or confirm that an update took effect. next_run_at and upcoming_runs show when the schedule runs next. Both are empty when the monitor has no schedule or isn’t active. To find an id, list your monitors. The response never carries webhook.secret. Your webhook handler needs the one from the create response to verify deliveries.

SDK, CLI and MCP

The SDK methods need SDK 0.2.0 or later. See SDKs → Monitors.

Authorizations

X-API-Key
string
header
required

Your API key, such as keen_.... Create one in the Keenable console. If you send both this header and Authorization, the API uses this one.

Path Parameters

id
string
required

The monitor's ID, such as mon_3kq9z2c8f1a04b7d9e6f5a21.

Response

The monitor

id
string
required
Example:

"mon_3kq9z2c8f1a04b7d9e6f5a21"

object
enum<string>
required
Available options:
monitor
name
string | null
required
Example:

"Open-weights LLM releases"

status
enum<string>
required

active and paused are set by you. completed: a once monitor after its run. disabled: set by Keenable after 10 failed runs in a row, or when no webhook delivery succeeded for 3 days. Only an active monitor matches pages.

Available options:
active,
paused,
disabled,
completed
schedule
object | null
required

All three keys are always present. timezone is UTC for a cron schedule sent without one, and null for interval and once.

webhook
object | null
required
metadata
object | null
required
last_run_at
string<date-time> | null
required

When the last run ended.

next_run_at
string<date-time> | null
required

The next scheduled run. null without a schedule or while the monitor isn't active.

upcoming_runs
string<date-time>[]
required

The next three run times, in UTC. Empty without a schedule or while the monitor isn't active.

created_at
string<date-time>
required
updated_at
string<date-time>
required
output_schema
object | null