> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List Snapshots

> Get a list of all snapshots.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

List Snapshots returns the automatic backups Square Cloud keeps for your applications or databases, each entry pairing a signed download URL fragment with its size and last-modified date. Use it to build a restore picker or audit retention in your own tooling instead of checking the dashboard manually.

Results are cached per user and scope for 30 minutes; a cache miss counts against a tighter limit of 3 calls per 60 seconds, after which the caller is blocked for 5 minutes. Listing snapshots requires a paid plan, an account with no active plan gets a 402.

Snapshots are grouped by scope, applications by default or databases via the `scope` parameter below. For application details, see [Get Application Info](/en/api-reference/endpoint/apps/info); for database details, see [Get Database Info](/en/api-reference/endpoint/databases/info).

### Parameters

<ParamField query="scope" type="string" default="applications">
  Specifies the type of snapshots to retrieve.

  * `applications` (default): Returns snapshots of applications
  * `databases`: Returns snapshots of databases
</ParamField>

### Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful.. `success` if successful, `error` if not.
</ResponseField>

<ResponseField name="response" type="object">
  The contents of the response.

  <Expandable title="Toggle object">
    <ResponseField name="name" type="string">
      The ID of the application to which the snapshot belongs.
    </ResponseField>

    <ResponseField name="size" type="number">
      Size of the snapshot in bytes.
    </ResponseField>

    <ResponseField name="modified" type="string">
      Date of the last modification of the snapshot.
    </ResponseField>

    <ResponseField name="key" type="string">
      AWS access key for the snapshot.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "status": "success",
    "response": [
      {
        "name": "1d2cdc0d6ebd435c91315c6329d12eab",
        "size": 12900705,
        "modified": "2024-06-27T06:23:42.326Z",
        "key": "AWSAccessKeyId=accesskey"
      },
      {
        "name": "1d2cdc0d6ebd435c91315c6329d12eab",
        "size": 12900705,
        "modified": "2024-06-26T07:05:40.000Z",
        "key": "AWSAccessKeyId=accesskey"
      }
    ]
  }
  ```
</ResponseExample>

<Note>The format of the URL to download the desired snapshot is: [https://snapshots.squarecloud.app/applications/\{accountID}/\{name}.zip?\{key}](https://snapshots.squarecloud.app/applications/\{accountID}/\{name}.zip?\{key})</Note>

### Common errors

| Code               | HTTP | Meaning                                                           |
| ------------------ | ---- | ----------------------------------------------------------------- |
| `INVALID_SCOPE`    | 400  | The `scope` query parameter is not `applications` or `databases`. |
| `UPGRADE_REQUIRED` | 402  | The account has no paid plan; listing snapshots requires one.     |