List WordPress sites
GET /api/v2/shared-hosting/{accountId}/wordpress
List the WordPress sites on a web hosting account. Check available first. When it is false, sites is empty and reason says why. An empty list then does not mean the account has no WordPress. A site installed by hand is listed only after GET /api/v2/shared-hosting/{accountId}/wordpress/actions/scan. Each site’s id is what the other WordPress calls take. The list is not paged.
Authentication: An API key with the scopes read:hosting and console:services. About keys and scopes
Request
Path parameters
accountIdstringrequiredThe web hosting account ID (
acct_…).Example
curl "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/wordpress" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The account’s WordPress sites.
{ "sites": [ { "id": "wp_01hxa3b4c5d6e7f8g9h0j1k2m3", "url": "https://example.com", "path": "/home/abcde/public_html", "domain": "example.com", "version": "6.5.5", "siteName": "Example Store", "database": "abcde_wp_example", "adminUsername": "admin", "installedAt": "2026-04-27T12:00:00.000Z" } ], "available": true, "reason": null}Response fields
sitesarray of objectThe WordPress sites.
idstringThe WordPress site ID (
wp_…).urlstringThe site’s address.
pathstringThe folder the site is installed in, on the server.
domainstringThe domain the site is on.
versionstringThe WordPress version.
siteNamestringThe site title.
databasestringThe name of the site’s database.
adminUsernamestring or nullThe admin username set at install. Null when unknown.
installedAtstring or nullWhen the site was installed. Null when unknown.
availablebooleanTrue when the list was read.
reasonstring or nullWhy the list could not be read. Null when
available is true.Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 409 | Conflict. code is account_suspended, account_not_eligible_cpanel. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists. |