> ## 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.

# Listar snapshots

> Obter uma lista de todos os snapshots relacionados a um único banco de dados.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

### Parâmetros

<ParamField path="database_id" type="string" placeholder="ID do banco de dados" required>
  O ID do banco de dados.
</ParamField>

### Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
</ResponseField>

<ResponseField name="response" type="array">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="name" type="string">
      O id do seu banco de dados hospedado na Square Cloud.
    </ResponseField>

    <ResponseField name="size" type="number">
      Tamanho do backup em bytes.
    </ResponseField>

    <ResponseField name="modified" type="string">
      Data da última modificação do backup.
    </ResponseField>

    <ResponseField name="key" type="string">
      Chave de acesso AWS para o backup.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status":"success",
    "response":[
      {
        "name":"a14b8d5e1cb7405a851eb4c075506121",
        "size":10644463,
        "modified":"2025-08-13T13:29:11.263Z",
        "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=VZ03MSxcNw3%2FtPezXv0IhTs0jq4%3D&versionId=45ec0b49-9af6-445e-a55c-abd7ec5278b2"
      },
      {
        "name":"a14b8d5e1cb7405a851eb4c075506121",
        "size":2742383,
        "modified":"2025-08-13T00:01:47.010Z",
        "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=7zw5apjyaOd1xPZl3gRgp8Y4yEs%3D&versionId=f65e1378-8717-45c5-8aec-bb233eedb5ce"
      }
    ]
  }
  ```
</ResponseExample>

<Note>O formato da URL para baixar o snapshot desejado é: [https://snapshots.squarecloud.app/databases/\{accountID}/\{name}.zip?\{key}](https://snapshots.squarecloud.app/databases/\{accountID}/\{name}.zip?\{key})</Note>