Get Monitor Sparkline

Retrieve 30 days of daily up/down data for a monitor

Overview

Return one entry per UTC day for roughly the last 30 days, suitable for drawing a compact uptime strip or chart.

GET https://api.uptimeio.com/api/monitors/{id}/sparkline

Authentication

Header	Required	Description
X-API-Key	Yes (or a Bearer token)	Any API key, including read-only keys. See Authentication.
X-Project-ID	No	Project that contains the monitor. Defaults to your organization’s default project.

Path parameters

Parameter	Type	Required	Description
id	UUID	Yes	Monitor ID.

Response

200 OK

{
  "success": true,
  "data": {
    "sparkline": [
      { "timestamp": "2026-09-01T00:00:00.000Z", "status": "success", "successCount": 1440, "failureCount": 0 },
      { "timestamp": "2026-09-02T00:00:00.000Z", "status": "failure", "successCount": 1310, "failureCount": 130 },
      { "timestamp": "2026-09-03T00:00:00.000Z", "status": "no-data", "successCount": 0, "failureCount": 0 }
    ]
  }
}

Field	Type	Description
timestamp	string	Start of the day, ISO 8601, midnight UTC.
status	enum	success, failure or no-data.
successCount	integer	Successful checks that day.
failureCount	integer	Failed checks that day.

How status is chosen:

• A day with results is success when successful checks are at least as many as failed ones, otherwise failure.
• A day with no results takes the status of the last day that had results.
• Days before the monitor’s first result are no-data.

For heartbeat monitors the counts come from received and missed pings.

Errors

Status	Code	Cause
401	AUTHENTICATION_REQUIRED / MISSING_AUTH / INVALID_API_KEY	Missing or invalid credentials.
404	MONITOR_NOT_FOUND	No monitor with this ID in the project.
500	SPARKLINE_FAILED	The data could not be loaded.

Example

cURL

curl https://api.uptimeio.com/api/monitors/MONITOR_ID/sparkline \
  -H "X-API-Key: YOUR_API_KEY"