Monitoring Data & Reports
API endpoints for retrieving monitoring data, check history, incident details, uptime stats, and PDF reports.
Monitoring Data
Get Uptime Stats
GET /api/websites/:websitePublicId/uptime-stats
Returns uptime percentages and average response times (day/month/year).
Get Check History
GET /api/websites/:websitePublicId/check-history
Returns the latest monitoring checks for a website.
Get Incident History
GET /api/websites/:websitePublicId/incident-history
Returns incidents for a website (latest 100).
Get Alert History
GET /api/websites/:websitePublicId/alert-history
Returns notification/escalation attempts for incidents of a website.
Get Monitoring Data
GET /api/websites/:websitePublicId/monitoring-data?range=day|week|month|year
Returns aggregated time series data used for charts.
Get Incident Details
GET /api/incidents/:incidentPublicId
Returns details of a specific incident.
List Incidents (Organization)
GET /api/incidents?organizationId=:organizationId
Lists incidents for an organization (scoped by your permissions).
Reports
Download PDF Report
GET /api/websites/:websitePublicId/report.pdf?period=last-week|last-month|last-quarter&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD
Downloads a generated PDF report for a website.
Uptime badge
Every website has a public SVG badge showing its uptime for the last 24 hours, 7 days or 30 days. It needs no authentication and is addressed by the website's publicId only; the integer id is not accepted (it answers 404).
https://uptimeify.io/api/public/badge/<websitePublicId>?period=30d| Parameter | Values | Default |
|---|---|---|
period | 7d, 30d; any other value or none means the last 24 hours | last 24 hours |
The response is image/svg+xml, cached for five minutes. Embed it as  in Markdown or as an <img> tag; the badge URL is also shown on the website's detail page.