Skip to main content
GET
/
api
/
v1
/
databases
/
{id}
/
backups
List backups
curl --request GET \
  --url https://api.example.com/api/v1/databases/{id}/backups
Returns all available backups for a database, sorted newest first.

​
Path parameters

ParameterTypeDescription
iduuidDatabase ID

​
Example

curl -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases/550e8400-e29b-41d4-a716-446655440000/backups

​
Response

200 OK
[
  {
    "filename": "20260319_120000.sql.gz",
    "sizeBytes": 5242880,
    "sizePretty": "5.0 MB",
    "createdAt": "2026-03-19T12:00:00.000Z"
  }
]
Returns an empty array if no backups exist yet. Use each filename with the download backup and delete backup routes when you need to fetch or remove a specific file.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key
404DATABASE_NOT_FOUNDDatabase doesn’t exist, isn’t owned by this user, or isn’t in scope for this key
500AGENT_ERRORThe VPS agent failed to list backups