---
title: "Capture history"
method: GET
path: "/v1/schedules/{scheduleId}/captures"
---

# Capture history

`GET /v1/schedules/{scheduleId}/captures`

## Request

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

Captures newest first, with download links valid for one hour. Page with the nextBefore cursor.

## Path parameters

- `scheduleId` string, uuid, required

## Query parameters

- `limit` integer
- `before` string, date-time

## Response `200`

Captures

- object
  - `captures` ScheduleCapture[]
    - `id` string, uuid
    - `status` 'completed' | 'failed'
    - `capturedAt` string, date-time
    - `diffPercent` number, nullable: Share of the page that changed since the previous capture, in percent. Null for the first capture.
    - `changed` boolean
    - `sha256` string, nullable
    - `bytes` integer, nullable
    - `width` integer, nullable
    - `height` integer, nullable
    - `renderMs` integer, nullable
    - `error` string, nullable
    - `downloadUrl` string, uri, nullable: Valid for one hour.
    - `expiresAt` string, date-time: When the capture is deleted under the plan's retention.
  - `nextBefore` string, date-time, nullable

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `404`: Schedule not found

---

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