---
title: "List the account's monitors"
method: GET
path: "/v1/monitors"
---

# List the account's monitors

`GET /v1/monitors`

## Request

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

## Response `200`

OK

- MonitorList
  - `results` Monitor[], required
    - `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
- `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)