Get Check History

GET /api/websites/:websitePublicId/check-history

Get Check History

GET /api/websites/:websitePublicId/check-history

Returns the latest monitoring checks for a website.

Query Parameters

  • limit (optional, default: 50, max: 200)
  • checkType (optional, supports values such as http_status, ssl_check, combined, playwright, heartbeat, dns, plus legacy values like http and ssl)

Path Parameters

  • websitePublicId (recommended): website public UUID
  • Backward compatibility: legacy numeric website IDs are still accepted

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET "$BASE_URL/api/websites/6bfec6f6-245a-47ce-843b-157d97d56f88/check-history?limit=25&checkType=dns" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Example Response

{
  "data": [
    {
      "id": "chk_01H...",
      "status": "success",
      "errorMessage": null,
      "warningMessage": null,
      "timingDns": 12,
      "diagnostics": null,
      "checkedAt": "2026-02-26T12:34:56.000Z",
      "locationId": 1,
      "locationName": "Frankfurt",
      "locationCode": "de-fra"
    }
  ]
}

Common Errors

  • 400 Invalid Website identifier if :websitePublicId is neither a valid UUID nor a legacy numeric ID
  • 400 Invalid checkType if you send an unsupported checkType
  • 401 Unauthorized if you are not authenticated
  • 403 Forbidden if you do not have access to the website