Skip to main content
GET
/
heartbeat
/
{monitorId}
curl "https://kodostatus.com/api/heartbeat/hb_abc123" \
  -H "X-API-Key: your_api_key"

{
  "status": "up",
  "last_ping": "2024-01-15T10:30:00Z",
  "expected_interval_seconds": 300
}
This endpoint requires API key authentication via the X-API-Key or Authorization: Bearer header.

​
Path Parameters

​
monitorId
string
required
The heartbeat monitor ID

​
Response

​
status
string
Current status: up, down, degraded
​
last_ping
string
ISO 8601 timestamp of last heartbeat
​
expected_interval_seconds
integer
Expected interval between heartbeats
curl "https://kodostatus.com/api/heartbeat/hb_abc123" \
  -H "X-API-Key: your_api_key"

{
  "status": "up",
  "last_ping": "2024-01-15T10:30:00Z",
  "expected_interval_seconds": 300
}