Skip to main content
Use this endpoint to retrieve all snapshots associated with a specific database. The response includes the size, modification date, and a pre-signed download key for each snapshot. You can use these details to inspect your backup history or to select a snapshot for a restore operation.

​
Request

GET https://api.virtuscloud.app/v2/databases/{databaseId}/snapshots

​
Headers

​
Authorization
string
required
Your Virtus Cloud API key. Pass it directly as the header value — no prefix required.Example: Authorization: vc_live_xxxxxxxxxxxx

​
Path Parameters

​
databaseId
string
required
The unique identifier of the database whose snapshots you want to list.

​
Response

​
status
string
Returns "success" when the request completes successfully.
​
response
array
An array of snapshot objects, ordered from most recent to oldest.

​
Examples

curl -X GET https://api.virtuscloud.app/v2/databases/a14b8d5e1cb7405a851eb4c075506121/snapshots \
  -H "Authorization: <api_key>"

​
Response Example

{
  "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"
    }
  ]
}