---
title: "List Snapshots"
method: GET
path: "/snapshots"
tags: ["snapshots", "Snapshots"]
---

# List Snapshots

`GET /snapshots`

List Snapshots

## Query parameters

- `cursor` string
- `per_page` integer

## Response `200`

A list of Snapshots objects.

- SnapshotEntity[]
  - `id` integer — The snapshot's unique ID.
  - `expires_at` string, date-time — When the snapshot expires.
  - `finalized_at` string, date-time — When the snapshot was finalized.
  - `name` string — A name for the snapshot.
  - `user_id` integer — The user that created this snapshot, if applicable.
  - `bundle_id` integer — The bundle using this snapshot, if applicable.
  - `workspace_id` integer — Workspace ID. `0` means the default workspace.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/versions/c80c746637fd/schema)