---
title: "Get snapshot download"
method: GET
path: "/snapshots/{snapshotId}/download"
tags: ["Box"]
---

# Get snapshot download

`GET /snapshots/{snapshotId}/download`

## Request

- Base URL: `https://ascii.dev/api/box/v1`
- URL: `https://ascii.dev/api/box/v1/snapshots/{snapshotId}/download`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ascii/apis/box-public-api-v1/docs/snapshots/:snapshotId/download/get.ts> (a function with typed inputs; its response is checked against the schema)

Return time-limited signed URLs for every chunk needed to reconstruct the box filesystem at this snapshot (the full chain, base through this generation), plus the inventory. Download the chunks and reassemble them as described by `reconstruct`. The `box snapshot pull` CLI command does this for you.

## Path parameters

- `snapshotId` string, uuid, required

## Response `200`

Signed chunk URLs for the snapshot chain.

- SnapshotDownloadResponse
  - `ok` boolean, required
  - `type` 'snapshot.download', required: Stable success envelope discriminator added by v1.
  - `snapshotId` string, uuid, required
  - `boxId` string, required
  - `kind` 'base' | 'incremental' | 'legacy', required
  - `generation` integer, required
  - `expiresInSeconds` integer, required: Lifetime of every `signedUrl` in this response.
  - `reconstruct` string, required: Human-readable note on how to reassemble the chunks into a filesystem.
  - `inventory` object, nullable
    - `r2Key` string, required
    - `signedUrl` string, uri, required
  - `chunks` SnapshotChunk[], required: Every chunk across the chain (all generations up to and including this snapshot), ordered by `(generation, chunkIndex)`.
    - `snapshotId` string, uuid, required
    - `generation` integer, required
    - `chunkIndex` integer, required
    - `r2Key` string, required
    - `sizeBytes` integer, required
    - `sha256` string, required
    - `signedUrl` string, uri, required: Time-limited download URL (see `expiresInSeconds`).

## 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.dev/ascii/apis/box-public-api-v1/revisions/82d576f82046?raw)