---
title: "List box snapshots"
method: GET
path: "/boxes/{boxId}/snapshots"
tags: ["Box"]
---

# List box snapshots

`GET /boxes/{boxId}/snapshots`

List completed snapshots for one box, newest first.

## Path parameters

- `boxId` string, required

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `sort` 'asc' | 'desc'

## Response `200`

Completed snapshots for this box.

- SnapshotListResponse
  - `ok` boolean, required
  - `type` 'snapshot.list', required — Stable success envelope discriminator added by v1.
  - `snapshots` SnapshotSummary[], required
    - `id` string, uuid, required
    - `boxId` string, required — Public Box id this snapshot belongs to.
    - `status` 'completed', required
    - `kind` 'base' | 'incremental' | 'null', nullable — `base` (full) or `incremental` (delta on a base). `null` for legacy snapshots.
    - `generation` integer, required — Position in the incremental chain (0 = base).
    - `chainId` string, uuid, nullable
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time, nullable
    - `sizeBytes` integer, required — Bytes this snapshot added (its delta), not the full restored size.
    - `fileCount` integer, required — Inventory entries alive in the chain at this generation (includes base-image system entries).
    - `contentSizeBytes` integer, nullable — Total bytes of your data restored by this snapshot (what resume/download returns; base image excluded). `null` on legacy snapshots.
    - `contentFileCount` integer, nullable — Number of your files restored by this snapshot (base image excluded). `null` on legacy snapshots.
  - `pageInfo` PageInfo
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required
    - `limit` integer, required

## Other responses

- `401` — Missing or invalid bearer token.
- `404` — Resource not found.

---

[API](https://skmtc.dev/ascii/apis/box-public-api-v1.md) · [All operations](https://skmtc.dev/ascii/apis/box-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ascii/box-public-api-v1/revisions/82d576f82046/schema)