---
title: "Get Check History"
description: "Returns the latest monitoring checks for a website."
---

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

## 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)

```bash
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

```json
{
  "data": [
    {
      "id": "chk_01H...",
      "status": "success",
      "errorMessage": null,
      "warningMessage": null,
      "timingDns": 12,
      "diagnostics": null,
      "checkedAt": "2026-02-26T12:34:56.000Z",
      "locationId": 7,
      "locationName": "Nuremberg (DE)",
      "locationCode": "de-nbg"
    }
  ]
}
```

## 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