List backups
curl --request GET \
--url https://api.example.com/api/v1/databases/{id}/backupsBackups
List backups
Get all backups for a database.
GET
/
api
/
v1
/
databases
/
{id}
/
backups
List backups
curl --request GET \
--url https://api.example.com/api/v1/databases/{id}/backupsReturns all available backups for a database, sorted newest first.Documentation Index
Fetch the complete documentation index at: https://docs.dbhost.app/llms.txt
Use this file to discover all available pages before exploring further.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | uuid | Database 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"
}
]
filename with the download backup and delete backup routes when you need to fetch or remove a specific file.
Errors
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 404 | DATABASE_NOT_FOUND | Database doesn’t exist, isn’t owned by this user, or isn’t in scope for this key |
| 500 | AGENT_ERROR | The VPS agent failed to list backups |
⌘I