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

# List backups

> Get all backups for a database.

Returns all available backups for a database, sorted newest first.

## Path parameters

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id`      | uuid | Database ID |

## Example

```bash theme={null}
curl -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases/550e8400-e29b-41d4-a716-446655440000/backups
```

## Response

```json 200 OK theme={null}
[
  {
    "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](/api-reference/backups/download) and [delete backup](/api-reference/backups/delete) 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                                             |