Skip to main content
GET
List monitors
List your organization’s monitors, newest first. Every list in the Monitors API has the same shape: data, has_more and next_cursor. To get the next page, pass next_cursor as cursor.

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.

Query Parameters

status
enum<string>

Only monitors in this status.

Available options:
active,
paused,
disabled,
completed
name
string

Only monitors whose name contains this text.

metadata[key]
string

Only monitors with this value under key in metadata, such as metadata[team]=research.

limit
integer
default:50

Items per page, 1 to 100. Any other value returns 400.

Required range: 1 <= x <= 100
cursor
string

The next_cursor of the previous page. A cursor that isn't in the list returns 400.

Response

A page of monitors

data
object[]
required
has_more
boolean
required

true if there are more items after this page.

next_cursor
string | null
required

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