Get a list of events for a heartbeat

Get all events from a heartbeat.

GET /v1/checks/heartbeats/{checkId}/events

Get a list of events for a heartbeat

cURL

curl --request GET \
  --url https://api.checklyhq.com/v1/checks/heartbeats/{checkId}/events \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "events": [
      {
        "id": "<string>",
        "state": "FAILING",
        "timestamp": "2023-07-24T10:01:01.098Z",
        "source": "HTTPS GET from Curl",
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36"
      }
    ],
    "stats": {
      "last24Hours": {
        "successRatio": {
          "previousPeriod": 123,
          "currentPeriod": 123
        },
        "totalEntitiesCurrentPeriod": 123
      },
      "last7Days": {
        "successRatio": {
          "previousPeriod": 123,
          "currentPeriod": 123
        },
        "totalEntitiesCurrentPeriod": 123
      }
    }
  }
]

Authorizations

Authorization · string · header · required

The Checkly Public API uses API keys to authenticate requests. You can get the API Key here. Your API key is like a password: keep it secure! Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID. For example, set Authorization header while using cURL: curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"

Headers

x-checkly-account · string

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Path Parameters

checkId · string · required

Query Parameters

startTime · string<date> · default: 2025-12-08T02:37:15.313Z

endTime · string<date> · default: 2025-12-09T02:37:15.313Z

limit · number · default: 10

Required range: x <= 10

Response

200

application/json

Successful

events · object[]

Show child attributes

stats · object

Show child attributes