## GET /api/v2/shared-hosting/{accountId}/backups/databases

**List database backups**

List the backups of single databases on a web hosting account, newest first. Each backup ID stands for one database at one point in time. Restoring one changes only that database. For backups of the whole account, use [`GET /api/v2/shared-hosting/{accountId}/backups`](/endpoints/webhosting-services/get-v2-shared-hosting-accountid-backups/). `actions.canRestore` on the list and on each backup says whether a restore can start now. The list is never partial. When the full list cannot be loaded, the call answers 502 `upstream_failed`. The account must be active. An account on Hostup's previous hosting platform returns an empty list.

### Related Endpoints

- `POST /api/v2/shared-hosting/{accountId}/backups/databases/{backupId}/actions/restore`: Restore a database backup
- `GET /api/v2/shared-hosting/{accountId}/backups`: List web hosting backups
- `GET /api/v2/shared-hosting/{accountId}/backups/queue/{queueRef}`: Get the status of a web hosting restore

### Headers

- `Authorization`: Bearer $HOSTUP_API_KEY
- Scopes: `read:hosting`, `console:services`

### Parameters

- `accountId` (path, string, required): The web hosting account ID (`acct_…`). Example: `acct_01hxa3b4c5d6e7f8g9h0j1k2m3`

### Request Example

```bash
curl "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/backups/databases" \
  -H "Authorization: Bearer $HOSTUP_API_KEY"
```

### Response Schema

- `backups` (array<object>, required)
- `backups[].id` (string, required): The database backup ID (`bkp_…`). Example: `bkp_01hxa3b4c5d6e7f8g9h0j1k2m3`
- `backups[].databaseName` (string, required): The database this backup holds. Example: `abcde_wp`
- `backups[].createdAt` (string, required, nullable): When the backup was taken. Example: `2026-08-01T23:20:00.000Z`
- `backups[].sizeBytes` (number, required, nullable): Size in bytes. Example: `20971520`
- `backups[].sizeMb` (number, required, nullable): Size in MB, rounded to two decimals. Example: `20`
- `backups[].encrypted` (boolean, required): True when the backup is stored encrypted. Example: `false`
- `backups[].note` (string, required, nullable): The note saved with the backup. Example: `null`
- `backups[].actions` (object, required)
- `backups[].actions.canRestore` (object, required): False when this backup is damaged or not available. `reason` says which.
- `backups[].actions.canRestore.allowed` (boolean, required) Example: `true`
- `backups[].actions.canRestore.reason` (string, required, nullable) Example: `null`
- `actions` (object, required)
- `actions.canRestore` (object, required): Whether a database restore can start now. `reason` says why not.
- `actions.canRestore.allowed` (boolean, required) Example: `true`
- `actions.canRestore.reason` (string, required, nullable) Example: `null`

### Responses

#### 200 - Database backups and whether a restore can start.
```json
{
  "backups": [
    {
      "id": "bkp_01hxa3b4c5d6e7f8g9h0j1k2m3",
      "databaseName": "abcde_wp",
      "createdAt": "2026-08-01T23:20:00.000Z",
      "sizeBytes": 20971520,
      "sizeMb": 20,
      "encrypted": false,
      "note": null,
      "actions": {
        "canRestore": {
          "allowed": true,
          "reason": null
        }
      }
    }
  ],
  "actions": {
    "canRestore": {
      "allowed": true,
      "reason": null
    }
  }
}
```

#### 400 - Invalid request. The response body is an RFC 7807 Problem Details document.
```json
{
  "type": "https://developer.hostup.se/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request is invalid.",
  "code": "invalid_request",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 401 - Unauthorized. Authentication is required.
```json
{
  "type": "https://developer.hostup.se/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication is required.",
  "code": "unauthorized",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 403 - Forbidden. The caller lacks a required scope or does not own the resource.
```json
{
  "type": "https://developer.hostup.se/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "The caller lacks a required scope or does not own the resource.",
  "code": "forbidden",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 404 - Not found. The resource does not exist or is not owned by the caller.
```json
{
  "type": "https://developer.hostup.se/errors/not_found",
  "title": "Not found",
  "status": 404,
  "detail": "The requested resource could not be found.",
  "code": "not_found",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 409 - Conflict. `code` is `account_suspended`.
```json
{
  "type": "https://developer.hostup.se/errors/account_suspended",
  "title": "Hosting account suspended",
  "status": 409,
  "detail": "The hosting account is suspended, so this action is unavailable until the account is reactivated.",
  "code": "account_suspended",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 429 - Rate limited. Retry after the limit resets. 429 responses include `Retry-After` seconds plus `X-RateLimit-*` headers.
```json
{
  "type": "https://developer.hostup.se/errors/rate_limit_exceeded",
  "title": "Too many requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please try again later.",
  "code": "rate_limit_exceeded",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 500 - Internal error. Retry later or contact support if the issue persists.
```json
{
  "type": "https://developer.hostup.se/errors/internal_error",
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error occurred. Retry later or contact support if the issue persists.",
  "code": "internal_error",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```

#### 502 - Upstream failure. A dependent provider request failed; the Problem Details `code` is `upstream_failed`. Retry later or contact support if the issue persists.
```json
{
  "type": "https://developer.hostup.se/errors/upstream_failed",
  "title": "Upstream failure",
  "status": 502,
  "detail": "An upstream provider request failed. Retry later or contact support if the issue persists.",
  "code": "upstream_failed",
  "instance": "/api/v2/resource",
  "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "timestamp": "2026-04-27T12:34:56.000Z"
}
```
