---
title: "Time-ranged results for one or many checks, raw or downsampled (REA-564)"
method: GET
path: "/checks/results"
tags: ["Checks"]
---

# Time-ranged results for one or many checks, raw or downsampled (REA-564)

`GET /checks/results`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/checks/results`
- Auth: HTTP bearer

## Query parameters

- `from` string, required
- `to` string, required
- `check_ids` string
- `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru'
- `step` string
- `cursor` string
- `limit` integer

## Response `200`

A page of raw results (`results`) or downsampled buckets (`buckets`); `meta` states the effective window and whether it was clamped.

- object
  - `results` object[]
    - `check_id` string, required
    - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru', required
    - `ok` boolean, required
    - `status_code` number, nullable, required
    - `latency_ms` number, nullable, required
    - `error` string, nullable, required
    - `checked_at` string, required
  - `buckets` object[]
    - `check_id` string, required
    - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru', required
    - `bucket_start` string, required
    - `sample_count` number, required
    - `ok_count` number, required
    - `p50_latency_ms` number, nullable, required
    - `p95_latency_ms` number, nullable, required
  - `next_cursor` string, nullable, required
  - `meta` object, required
    - `from` string, required
    - `to` string, required
    - `requested_from` string, required
    - `requested_to` string, required
    - `clamped` boolean, required
    - `tier` string, required
    - `history_days` number, required
    - `check_ids` string[], required
    - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru', nullable, required
    - `step` string, nullable, required
    - `row_cap` number, required
    - `rows` number, required

## Other responses

- `400`: Missing/invalid from or to, from not before to, an invalid check_ids entry or too many of them, an invalid step, region, cursor, or limit. - `RU-3012` Invalid results query request: https://realuptime.io/kb/errors/ru-3012
- `401`: Missing, invalid, or revoked API key. - `RU-1001` Missing API credentials: https://realuptime.io/kb/errors/ru-1001 - `RU-1002` Invalid or revoked API key: https://realuptime.io/kb/errors/ru-1002
- `403`: This key is IP-restricted and the request came from outside its allowlist. - `RU-1007` API key is restricted to an IP allowlist: https://realuptime.io/kb/errors/ru-1007
- `429`: Per-key rate limit exceeded, a Free account's per-account request budget exceeded, or too many failed authentication attempts. - `RU-2002` API read rate limit exceeded: https://realuptime.io/kb/errors/ru-2002 - `RU-2001` Too many failed authentication attempts: https://realuptime.io/kb/errors/ru-2001

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)