---
title: "List scheduled captures"
method: GET
path: "/v1/schedules"
---

# List scheduled captures

`GET /v1/schedules`

## Request

- Base URL: `https://app.snap-render.com`
- URL: `https://app.snap-render.com/v1/schedules`
- Auth: API key in header `X-API-Key`

All schedules on the account, newest first, with the plan's limits.

## Response `200`

Schedules

- object
  - `schedules` Schedule[]
    - `id` string, uuid
    - `name` string, nullable
    - `url` string, uri
    - `interval` 'hourly' | 'daily' | 'weekly'
    - `format` 'png'
    - `options` object: Render options, same names as the batch endpoint.
    - `changeThreshold` number
    - `notifyEmail` boolean
    - `isActive` boolean
    - `pausedReason` 'user' | 'plan' | 'failures' | 'account' | 'null', nullable
    - `consecutiveFailures` integer
    - `lastError` string, nullable
    - `lastRunAt` string, date-time, nullable
    - `nextRunAt` string, date-time, nullable
    - `createdAt` string, date-time
  - `limits` object
    - `plan` string
    - `eligible` boolean
    - `maxSchedules` integer
    - `retentionDays` integer
    - `used` integer

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api.md) · [All operations](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/revisions/420ff88deeb2?raw)