GET
/
v1
/
checks
/
heartbeats
/
{checkId}
/
events
Get a list of events for a heartbeat
curl --request GET \
  --url https://api.checklyhq.com/v1/checks/heartbeats/{checkId}/events \
  --header 'Authorization: <api-key>'
[
  {
    "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
      }
    }
  }
]

​
Overview

The List Heartbeat Events endpoint returns all events (pings) received for a specific heartbeat check. Events include timestamps, status information, and metadata about each heartbeat signal. Common Use Cases:
  • Event History Review
  • Process Activity Tracking
  • Troubleshooting Missed Pings
  • Schedule Verification
Heartbeat events show the complete ping history for your monitored processes, including successful pings, late arrivals, and missed signals.

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-08-10T17:25:40.611Z
​
endTime
string<date>
default:2025-08-11T17:25:40.611Z
​
limit
number
default:10
Required range: x <= 10

Response

Successful

​
events
object[]
​
stats
object