Skip to content
HostupDevelopers
GuidesAPI referenceSupport

List database backups

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

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

Authentication: An API key with the scopes read:hosting and console:services. About keys and scopes

Request

Path parameters

accountIdstringrequired
The web hosting account ID (acct_…).

Example

GET /api/v2/shared-hosting/{accountId}/backups/databases
curl "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/backups/databases" \
  -H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 Database backups and whether a restore can start.

Response 200
{
  "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
    }
  }
}
Response fields
backupsarray of object
idstring
The database backup ID (bkp_…).
databaseNamestring
The database this backup holds.
createdAtstring or null
When the backup was taken.
sizeBytesnumber or null
Size in bytes.
sizeMbnumber or null
Size in MB, rounded to two decimals.
encryptedboolean
True when the backup is stored encrypted.
notestring or null
The note saved with the backup.
actionsobject
canRestoreobject
False when this backup is damaged or not available. reason says which.
allowedboolean
reasonstring or null
actionsobject
canRestoreobject
Whether a database restore can start now. reason says why not.
allowedboolean
reasonstring or null

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller.
409Conflict. code is account_suspended.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.

This page as MarkdownOpenAPI spec