---
title: "A monitor's run history, newest first (runs are kept 30 days, their results 24 hours)"
method: GET
path: "/v1/monitors/{id}/runs"
---

# A monitor's run history, newest first (runs are kept 30 days, their results 24 hours)

`GET /v1/monitors/{id}/runs`

## Request

- Base URL: `https://api.serpkite.com`
- URL: `https://api.serpkite.com/v1/monitors/{id}/runs`
- Auth: HTTP bearer

## Response `200`

OK

- MonitorRunList
  - `results` MonitorRun[], required
    - `id` string, uuid, required
    - `status` 'ok' | 'error' | 'webhook_failed' | 'paused', required
    - `error` string, nullable
    - `new_results` integer, required
    - `results` object[], nullable: The new results (OrganicResult-shaped for search, NewsResult for news, MonitorPageChange for webpage); null when there were none or after 24 hours
    - `credits_used` number, required
    - `webhook_status` 'delivered' | 'failed' | 'none' | 'null', nullable: none = the monitor has no webhook; null = nothing to send
    - `created_at` string, date-time, required
  - `next_before` string, uuid, nullable, required: Pass as `before` for the next page; null on the last page

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `429`: Error

---

[API](https://skmtc.dev/serpkite/apis/serpkite-serp-api.md) · [All operations](https://skmtc.dev/serpkite/apis/serpkite-serp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/serpkite/apis/serpkite-serp-api/revisions/f2c6dd05cfc5?raw)