---
title: "Get a monitor"
method: GET
path: "/v1/monitors/{id}"
---

# Get a monitor

`GET /v1/monitors/{id}`

## Request

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

## Response `200`

OK

- Monitor
  - `id` string, uuid, required
  - `name` string, required
  - `endpoint` 'search' | 'news' | 'webpage', required
  - `request` MonitorSearch, required: The saved request a monitor reruns: a search (q and options) or, for webpage monitors, url (and country)
    - `q` string
    - `url` string
    - `country` string
    - `language` string
    - `location` string
    - `time` 'hour' | 'day' | 'week' | 'month' | 'year'
    - `num` integer
    - `device` string
    - `safe` string
    - `include_domains` string[]
    - `exclude_domains` string[]
    - `engine` string[]
  - `metadata` object, nullable
  - `interval_seconds` integer, required
  - `webhook_url` string, nullable, required: Null when new results are only kept in the run history
  - `active` boolean, required
  - `next_run_at` string, date-time, required
  - `last_run_at` string, date-time, nullable
  - `last_status` 'ok' | 'error' | 'webhook_failed' | 'paused' | 'null', nullable
  - `last_error` string, nullable
  - `last_new_results` integer: New results found by the last run
  - `runs` integer, required
  - `consecutive_failures` integer, required: Failed runs in a row; the monitor pauses itself at 10
  - `credits_used` number, required: Total over all runs
  - `created_at` string, date-time, required

## Other responses

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