---
title: "List the authenticated user's snapshots"
method: GET
path: "/v2/users/snapshots"
tags: ["Snapshots"]
---

# List the authenticated user's snapshots

`GET /v2/users/snapshots`

Lists application or database snapshots owned by the authenticated user. Rate limited to 3 calls per 60s (blocking 5 minutes) and requires a paid plan.

Use the `scope` query parameter to switch between `applications` (default) and `databases`.

## Query parameters

- `scope` 'applications' | 'databases'

## Response `200`

Snapshot list for the requested scope.

- object
  - `status` 'success', required
  - `response` Snapshot[], required
    - `name` string, required — Snapshot identifier (zip name without extension).
    - `size` integer, required — Snapshot size in bytes.
    - `modified` string, date-time, required
    - `key` string, required — Signed query string used to compose the snapshot download URL.

## Other responses

- `400` — The `scope` query parameter is not one of the allowed values.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `402` — Listing snapshots requires a paid subscription.
- `429` — The user exceeded the cache-miss rate limit (3 calls per 60s).
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)