Skip to content

List web hosting backups

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

List the full-account restore points of a web hosting account, newest first. A full-account backup holds the website files, databases and email. To find a backup of one database, use GET /api/v2/shared-hosting/{accountId}/backups/databases. actions.canRestore says whether a restore can start now. reason says why not. The list also works while the account is suspended. 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
curl "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/backups" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 Restore points and whether a restore can start.

Response 200
{
"backups": [
{
"id": "bkp_01hxa3b4c5d6e7f8g9h0j1k2m3",
"createdAt": "2026-07-10T01:15:00.000Z",
"sizeBytes": 2147483648,
"sizeGb": 2,
"backupType": "full_account",
"encrypted": true,
"note": null
}
],
"actions": {
"canRestore": {
"allowed": true,
"reason": null
}
}
}
Response fields
backupsarray of object
idstring
The restore point ID (bkp_…).
createdAtstring or null
When the backup was taken.
sizeBytesnumber or null
Size in bytes.
sizeGbnumber or null
Size in GB, rounded to two decimals.
backupTypestring
full_account holds the whole account. partial holds only part of it. One of full_account, partial.
encryptedboolean
True when the backup is stored encrypted.
notestring or null
The note saved with the backup.
actionsobject
canRestoreobject
Whether a 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.
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.