GET/v2/healthchecks

Get all healthchecks

Returns a list of all healthchecks for a project.

Request

This endpoint does not require any parameters.

Response

Returns an array of healthcheck objects.

Healthcheck Object Fieldsapplication/json

uuidstring

Unique identifier for the healthcheck

namestring

Healthcheck name

pingUrlstring

URL to ping for this healthcheck

cronstring

Cron expression (if using cron mode)

tzstring

Timezone for cron expression

periodValuenumber

Period interval value (if using simple mode)

periodTypestring

Period interval unit (seconds, minutes, hours, days)

gracePeriodValuenumber

Grace period value before alerting

gracePeriodTypestring

Grace period unit

isDownboolean

Whether the healthcheck is currently down

lastPingstring

ISO 8601 timestamp of the last ping received

dueDatestring

ISO 8601 timestamp when the next ping is expected

RequestcURL

curl https://api.hyperping.io/v2/healthchecks \
  -H "Authorization: Bearer ${API_TOKEN}"

200 OKJSON

{
  "healthchecks": [
    {
      "uuid": "tok_abc123def456",
      "name": "Daily Backup Job",
      "pingUrl": "https://hc.hyperping.io/tok_abc123def456",
      "cron": "0 2 * * *",
      "tz": "UTC",
      "period": 0,
      "periodValue": null,
      "periodType": null,
      "gracePeriod": 300,
      "gracePeriodValue": 5,
      "gracePeriodType": "minutes",
      "createdAt": "2026-01-15T10:00:00.000Z",
      "lastPing": "2026-01-23T02:00:15.000Z",
      "dueDate": "2026-01-24T02:05:00.000Z",
      "isDown": false,
      "lastLogStartDate": "2026-01-23T02:00:00.000Z",
      "lastLogEndDate": "2026-01-23T02:00:15.000Z"
    }
  ]
}

← Healthchecks API Get a healthcheck →