---
title: "Get a snapshot"
method: GET
path: "/v2/sandboxes/snapshots/{snapshotId}"
tags: ["sandboxes"]
---

# Get a snapshot

`GET /v2/sandboxes/snapshots/{snapshotId}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/sandboxes/snapshots/{snapshotId}`
- Auth: HTTP bearer

Retrieves detailed information about a specific snapshot, including its creation time, size, expiration date, and the source session it was created from.

## Path parameters

- `snapshotId` string, required: The unique identifier of the snapshot to retrieve.

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

- object
  - `snapshot` Snapshot, required: This object contains information related to a Snapshot of a Vercel Sandbox session (v2 API).
    - `architecture` 'amd64' | 'arm64': CPU architecture required to restore the snapshot.
    - `createdAt` number, required: The time when the snapshot was created, in milliseconds since the epoch.
    - `creationMethod` 'automatic' | 'manual': The method used to create the snapshot.
    - `expiresAt` number: The time when the snapshot will expire, in milliseconds since the epoch. If not set, the snapshot does not have any expiration.
    - `id` string, required: The unique identifier of the snapshot.
    - `lastUsedAt` number, required: The last time the snapshot was used (e.g. to resume or create a sandbox), in milliseconds since the epoch. Falls back to `createdAt` for older snapshots that predate this field.
    - `parentId` string: The unique identifier of the parent snapshot, if this snapshot was created from another snapshot.
    - `region` string: The region where the snapshot is stored.
    - `regions` string[]: The regions where the snapshot is available.
    - `sizeBytes` number, required: The size of the snapshot in bytes.
    - `sourceSessionId` string, required: The unique identifier of the session from which the snapshot was created.
    - `status` 'created' | 'deleted' | 'failed', required: The status of the snapshot.
    - `updatedAt` number, required: The last time the snapshot was updated, in milliseconds since the epoch.
    - `workloadType` 'sandbox' | 'v0': The workload type of this snapshot.

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `422`
- `429`

## Changes

- **2026-10-26** `01d3fe4ea5c3`: 1 warning, 1 info
  - removed the optional property `snapshot/v0` from the response with the `200` status
  - added the optional property `snapshot/workloadType` to the response with the `200` status
- **2026-10-24** `4a06e85c2848`: 1 info
  - added the non-success response with the status `422`
- **2026-10-01** `9958fd10bb05`: 1 info
  - added the optional property `snapshot/v0` to the response with the `200` status
- **2026-09-18** `c32b8afee578`: 1 info
  - added the optional property `snapshot/architecture` to the response with the `200` status
- **2026-08-21** `915cc4809c98`: 1 info
  - added the optional property `snapshot/regions` to the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v2/sandboxes/snapshots/:snapshotId/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)