List pending orders
GET /api/v2/me/pending-orders
Returns your most recent unfinished order that is still unpaid, if there is one. The response is { pendingOrders } with at most one order. It is pending, has an unpaid invoice and was placed in the last 30 days. Automatic orders such as domain renewals are left out. So are large orders and orders for products other than web hosting, VPS or domains. An empty list does not mean the account has no unpaid invoice. The order completes when its invoice is paid. There is no general GET /api/v2/orders collection endpoint. To see every recent order that is still being set up, use GET /api/v2/me/open-orders.
Authentication: An API key with the scope read:orders. About keys and scopes
Example
curl "https://cloud.hostup.se/api/v2/me/pending-orders" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 Your unfinished unpaid order. The list is empty when there is none.
{ "pendingOrders": [ { "id": "ord_01hxa3b4c5d6e7f8g9h0j1k2m3", "number": "1117145835", "createdAt": "2026-10-28T09:30:00.000Z", "type": "new", "billing": { "amount": 249, "currencyCode": "SEK", "billingCycle": "monthly" }, "items": [ { "name": "VPS S", "amount": 249, "currencyCode": "SEK" } ], "invoice": { "id": "inv_01hxa3b4c5d6e7f8g9h0j1k2m3", "number": "202689534", "total": 249, "currencyCode": "SEK", "dueAt": "2026-11-04T00:00:00.000Z" } } ]}{ "pendingOrders": []}Response fields
pendingOrdersarray of objectidstringord_…).numberstring or nullcreatedAtstringtypestringnew. One of new, renew, transfer, upgrade.billingobjectamountnumbercurrencyCode.currencyCodestringSEK.billingCyclestringmonthly here. It does not say how the ordered products are billed.itemsarray of objectnamestringamountnumbercurrencyCode.currencyCodestringSEK.invoiceobject | nullidstringinv_…).numberstring or nulltotalnumbercurrencyCode.currencyCodestringSEK.dueAtstring or nullErrors
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. |