Monitors

GET /monitors/{id}/history

Changed on Oct 7, 2026

Lists the notifications sent for the monitor between startTime and endTime. Each delivery is a separate item: one per notifier, and one per recipient for email notifiers. Failed deliveries are included. State changes that sent no notification, for example while the monitor had no notifiers, aren't listed. The caller needs query access to the monitor's datasets.

Request

Base URL
https://api.axiom.co/v2
Auth
OAuth 2
Authorization codehttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://www.googleapis.com/oauth2/v4/token
Scopesmonitors|read
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/monitors/:id/history/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Monitor ID.

Query parameters

startTimestring date-time required

Start of the time range (RFC 3339).

endTimestring date-time required

End of the time range (RFC 3339). Must not be before startTime.

Response

Notifications sent in the time range.

checkIdstring required

ID of the monitor

namestring required

Title of the notification: Triggered: or Resolved: followed by the monitor name

state'open' | 'closed' required

open if the notification reported that the monitor triggered, closed if it reported that the monitor resolved

timestampstring date-time required

Time the delivery was recorded, after any retries

Example response

[
  {
    "checkId": "QgOLFXIvK0ZbYf3tZE",
    "name": "Triggered: High CPU usage",
    "state": "open",
    "timestamp": "2024-03-20T15:30:00Z"
  }
]

Changes

Oct 7, 2026v22d43a0b7f717 Revision changes
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history