Monitoring Results API

Query check results and uptime summaries for any endpoint.

Get results for an endpoint

GET /api/v1/endpoints/:id/results?limit=100&from=2025-01-01&to=2025-01-31

Returns a paginated list of check results. Query parameters:

limit — max results to return (default 100, max 1000)
from — start date in ISO 8601 format
to — end date in ISO 8601 format

Get latest result

GET /api/v1/endpoints/:id/results/latest

Uptime summary

GET /api/v1/endpoints/:id/uptime?period=30d

Valid period values: 24h, 7d, 30d, 90d.

{
  "uptime_percent": 99.87,
  "total_checks": 43200,
  "successful_checks": 43144,
  "failed_checks": 56,
  "avg_response_time_ms": 142
}

Result object

{
  "id": "res_abc123",
  "endpoint_id": "ep_xyz789",
  "status": "success",
  "response_time_ms": 142,
  "status_code": 200,
  "error": null,
  "region": "us-east-1",
  "checked_at": "2025-01-15T10:30:00Z"
}

The status field is either success or failure. On failure, error contains the failure reason.