List WordPress sites on several accounts
POST /api/v2/shared-hosting/wordpress/batch
Lists the WordPress sites on up to 50 web hosting accounts in one call. For one account, use GET /api/v2/shared-hosting/{accountId}/wordpress. IDs that do not exist or are not on your account are left out of results. An empty accountIds returns an empty results list.
available says whether WordPress management works on the account. reason says why not. An account whose sites could not be read in time comes back with available: false and a reason that asks you to try again.
The call can also start a background search for WordPress sites that were not installed through Hostup. A finished search is not repeated for 24 hours. Sites it finds are added to WordPress management. While the search runs, refreshPending is true. Read the account again shortly to see what it finds.
Authentication: An API key with the scope read:services. About keys and scopes
Request
Body
accountIdsarray of stringrequiredacct_…), at most 50.Example
curl -X POST "https://cloud.hostup.se/api/v2/shared-hosting/wordpress/batch" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "accountIds": [ "acct_01hxa3b4c5d6e7f8g9h0j1k2m3" ] }'curl -X POST "https://cloud.hostup.se/api/v2/shared-hosting/wordpress/batch" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "accountIds": [ "acct_01hxa3b4c5d6e7f8g9h0j1k2m3", "acct_01hxa3b4c5d6e7f8g9h0j1k2m4" ] }'Responses
200 WordPress sites per account.
{ "results": [ { "id": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3", "available": true, "reason": null, "installations": [ { "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" } ], "refreshPending": false } ]}Response fields
resultsarray of objectidstringacct_…).availablebooleanfalse when the account is not active, is not on cPanel or its sites could not be read in time.reasonstring or nullavailable is false. null when available is true.installationsarray of objectavailable is false.idstringwp_…).urlstringpathstringdomainstringversionstringsiteNamestringwww. when the site has no title.databasestringadminUsernamestring or nullinstalledAtstring or nullrefreshPendingbooleantrue while a background search for more WordPress sites runs on this account. Read the account again shortly to see what it finds.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. |
| 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. |