Getting Alerts

This will get a list of the alerts.

GET /api/v0/alerts

Required permissions for API key

  • Read

Input (Query parameters)

You can filter alerts with the following parameters. If withClosed is not specified, only open alerts are returned. If nextId is not specified, alerts will be returned in order of latest occurrence time.

withClosed boolean [optional] Whether or not to get resolved alerts. If true, resolved alerts as well as open alerts are retrieved.
nextId string [optional] If nextId is specified, alerts older than the id of the specified alert are retrieved.
limit number [optional] The maximum number of alerts to retrieve. When omitted, up to 100 cases are retrieved. The most that can be specified is 100.


  "alerts": [<alert>, <alert>, ...],
  "nextId": xxx

Alerts will be in chronological order of when they were generated from newest to oldest. nextId is retrieved when there are more alerts.

<alert>: an object that holds the following keys.

id string alert's ID
status string alert's current status: "OK", "CRITICAL", "WARNING", or "UNKNOWN"
monitorId string ID of the monitor that generated the alert
type string the type of monitor: connectivity ("connectivity"), host metric ("host"), service metric ("service"), external monitor ("external"), check monitor ("check"), expression monitor ("expression"), or anomaly detection for roles ("anomalyDetection")
hostId string [optional] the associated host ID. only exists when the type of monitor is either "connectivity", "host", "check", or "anomalyDetection"
value number [optional] value of the monitoring target. only exists when the type of monitor is "host", or "service" or when there is a reponse time configuration in "external"
message string [optional] monitoring target's message. only exists when the type of monitor is either "check" or "external"
reason string [optional] reason that the alert was closed. does not exist if the alert is unresolved.
openedAt number time stamp when the alert was generated (unix time)
closedAt number [optional] time stamp when the alert was resolved (unix time). only exists if the alert is already resolved


400 when `limit` value is larger than maximum allowed value(100)

Closing Alerts

The designated alert will be closed.

POST /api/v0/alerts/<alertId>/close

Required permissions for API key

  • Read
  • Write


  "reason": <text>

Any text can be appended in the reason field. This field is a required item.



A post-update alert will be returned.

  "id": "<alertId>",
  "status": "OK",
  "reason": <reason>,
  "opendAt": <opendAt>,
  "closedAt": <closedAt>

This is the same as the <alert> object in Getting Alerts. reason and closedAt exist.


404 when the <alertId>'s corresponding alert can't be found
403 when the API doesn't have the required permissions / when accessing from outside the permitted IP address range