---
title: "List recurring On-Page.ai scan schedules for the caller's organization."
method: GET
path: "/v1/scheduled-scans"
tags: ["Scheduled scans"]
---

# List recurring On-Page.ai scan schedules for the caller's organization.

`GET /v1/scheduled-scans`

## Request

- Base URL: `https://api.on-page.ai`
- URL: `https://api.on-page.ai/v1/scheduled-scans`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/on-page/apis/on-page-ai-api/docs/v1/scheduled-scans/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Schedules with next-run preview and current-month spend.

- ScheduledScanListResponse
  - `schedules` object[], required
    - `id` string, required
    - `name` string, required
    - `url` string, uri, required
    - `keyword` string, required
    - `depth` 'lite' | 'standard' | 'deep', required
    - `region` string, required
    - `locale` string, nullable, required
    - `cadence` object, required
      - `frequency` 'daily' | 'weekly' | 'monthly', required
      - `timezone` string, required
      - `time` string, required
      - `day_of_week` integer
      - `day_of_month` integer
    - `status` 'active' | 'paused', required
    - `pause_reason` string, nullable, required
    - `max_credits_per_run` number, required
    - `monthly_credit_budget` number, required
    - `current_month_spend` number, required
    - `alert_thresholds` object
      - `score_drop` number
      - `entity_loss_count` integer
      - `competitor_gap_increase` number
    - `next_run_at` string, nullable, required
    - `last_run_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `401`: Unauthorized
- `403`: Scope forbidden
- `429`: Too many requests. Body is a `oneOf` of rate-limit / org-active-limit / org-queued-limit / scan-queue-saturated variants — branch on `error.code`. `Retry-After` is present when the limiter emits it; `X-RateLimit-*` is present on rate-limit-middleware 429s; `X-Concurrency-*` is present on concurrency-limit 429s (ORG_ACTIVE_LIMIT_REACHED / ORG_QUEUED_LIMIT_REACHED).
- `500`: Internal error
- `503`: Scheduled scans are disabled in this environment.

---

[API](https://skmtc.dev/on-page/apis/on-page-ai-api.md) - [All operations](https://skmtc.dev/on-page/apis/on-page-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/on-page/apis/on-page-ai-api/revisions/a081e8701c19?raw)