---
title: "The snapshots the account behind the key owns or was given access to, newest first, each with access owner or reader. Needs an account-bound key (a Pro account’s dck_ key); a share token or an anonymous key answers 401 account_key_required. Free."
method: GET
path: "/snapshots"
---

# The snapshots the account behind the key owns or was given access to, newest first, each with access owner or reader. Needs an account-bound key (a Pro account’s dck_ key); a share token or an anonymous key answers 401 account_key_required. Free.

`GET /snapshots`

## Request

- Base URL: `https://app.difficat.com/api/v1`
- URL: `https://app.difficat.com/api/v1/snapshots`
- Auth: HTTP bearer

## Response `200`

OK

- SnapshotList
  - `snapshots` Snapshot[], required
    - `id` string, required
    - `label` string, required
    - `origin` string, uri, required: The captured site’s origin; it is never fetched by a compare.
    - `viewportWidth` integer, required
    - `checkMode` 'full' | 'text-only' | 'existence-only', required
    - `pageCount` integer, required
    - `errorPages` integer: Pages that answered with an error status or were unreachable.
    - `status` 'capturing' | 'ready', required
    - `via` 'capture' | 'run'
    - `createdAt` integer, required: Epoch ms.
    - `updatedAt` integer, required: Epoch ms.
    - `completedAt` integer: Epoch ms.
    - `access` 'owner' | 'reader', required: The caller’s role on the snapshot.

## Other responses

- `401`: No key, a share token, or a key with no active account behind it (credential_required or account_key_required)
- `429`: More than 1,000 reads this hour for this key or token (Retry-After)
- `503`: Snapshots are not available on this deployment

---

[API](https://skmtc.dev/difficat/apis/difficat-agent-api.md) · [All operations](https://skmtc.dev/difficat/apis/difficat-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/difficat/apis/difficat-agent-api/revisions/49c291e77659?raw)