Skip to content

List open cancellation requests

GET /api/v2/cancellations

List the open cancellation requests for the account’s VPS and web hosting services. Requests that are already done are left out. The list can be up to 30 seconds old. Each item’s type says which service it is. To see one request or withdraw it, use GET or DELETE on /api/v2/vps/{id}/cancellation or /api/v2/shared-hosting/{accountId}/cancellation.

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

Example

GET /api/v2/cancellations
curl "https://cloud.hostup.se/api/v2/cancellations" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 The open cancellation requests.

Response 200
{
"cancellations": [
{
"type": "shared_hosting",
"accountId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3",
"cancellation": {
"accountId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3",
"status": "pending",
"cancelledAt": "2026-04-27T12:34:56.000Z",
"scheduledAt": "2026-04-27T12:34:56.000Z",
"reason": "Requested by customer",
"cancelType": "end_of_period",
"revokable": true
}
}
]
}
Response fields
cancellationsarray of object
The account’s current cancellations in one response. This endpoint has no paging.
typestring
One of vps, shared_hosting.
vpsIdstring
Present when type is vps.
accountIdstring
Present when type is shared_hosting.
cancellationany

Errors

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

401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
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.