> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uptimeio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Check Results

> Retrieve the most recent individual check results for a monitor

## Overview

Return the latest raw check results for a monitor from the last 7 days, newest first. Each result is one check run from one probe location.

```
GET https://api.uptimeio.com/api/monitors/{id}/check-results
```

## Authentication

| Header | Required | Description |
| - | - | - |
| `X-API-Key` | Yes (or a Bearer token) | Any API key, including read-only keys. See [Authentication](/api-reference/authentication). |
| `X-Project-ID` | No | Project that contains the monitor. Defaults to your organization's default project. |

## Path and query parameters

| Parameter | In | Type | Default | Description |
| - | - | - | - | - |
| `id` | path | UUID | required | Monitor ID. |
| `limit` | query | integer | `10` | Maximum number of results, 1-1000. Only results from the last 7 days are returned. |

## Response

### 200 OK

```json theme={null}
{
  "success": true,
  "data": {
    "results": [
      {
        "id": "b7a2c1de-3f54-4c21-9d0a-6e1f2a3b4c5d-1767090000000-7",
        "timestamp": "2026-09-30T08:20:00.000Z",
        "status": "success",
        "responseTime": 184,
        "statusCode": 200,
        "region": "Amsterdam",
        "checkType": "HTTP",
        "dnsTime": 12,
        "connectTime": 31,
        "tlsTime": 48,
        "ttfbTime": 96
      },
      {
        "id": "b7a2c1de-3f54-4c21-9d0a-6e1f2a3b4c5d-1767089940000-7",
        "timestamp": "2026-09-30T08:19:00.000Z",
        "status": "failure",
        "responseTime": 10000,
        "region": "Singapore",
        "checkType": "HTTP",
        "error": "Request timed out"
      }
    ]
  }
}
```

| Field | Type | Description |
| - | - | - |
| `id` | string | Identifier of the result. |
| `timestamp` | string | When the check ran, ISO 8601. |
| `status` | enum | `success` or `failure`. |
| `responseTime` | integer | Response time in milliseconds (`0` if none was recorded). |
| `statusCode` | integer | HTTP status code, for HTTP and keyword checks. |
| `region` | string | City name of the probe location that ran the check, for example `Amsterdam`. `Unknown` if the location was not recorded. See [Probe locations](/monitors/probe-locations). |
| `checkType` | string | The monitor type. |
| `error` | string | Failure reason, when the check failed. |
| `dnsTime`, `connectTime`, `tlsTime`, `ttfbTime` | integer | Timing breakdown in milliseconds (DNS lookup, TCP connect, TLS handshake, time to first byte), when measured. |
| `typeSpecificData` | object | Extra detail for some monitor types, when recorded. |

Optional fields are omitted when they have no value.

## Errors

| Code | Status | Meaning |
| - | - | - |
| `INVALID_LIMIT` | 400 | `limit` is not between 1 and 1000. |
| `AUTHENTICATION_REQUIRED` / `MISSING_AUTH` / `INVALID_API_KEY` | 401 | Missing or invalid credentials. |
| `MONITOR_NOT_FOUND` | 404 | No monitor with this ID in the project. |
| `CHECK_RESULTS_FAILED` | 500 | The results could not be loaded. |

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.uptimeio.com/api/monitors/MONITOR_ID/check-results?limit=50" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    'https://api.uptimeio.com/api/monitors/MONITOR_ID/check-results?limit=50',
    { headers: { 'X-API-Key': process.env.UPTIMEIO_API_KEY } },
  );
  const { data } = await res.json();
  console.log(data.results.filter((r) => r.status === 'failure').length, 'failures');
  ```

  ```python Python theme={null}
  import os
  import requests

  res = requests.get(
      "https://api.uptimeio.com/api/monitors/MONITOR_ID/check-results",
      headers={"X-API-Key": os.environ["UPTIMEIO_API_KEY"]},
      params={"limit": 50},
  )
  results = res.json()["data"]["results"]
  print(sum(1 for r in results if r["status"] == "failure"), "failures")
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.