Skip to content

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

GET /api/v2/me/pending-orders
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"
}
}
]
}
Response fields
pendingOrdersarray of object
At most one order.
idstring
The order ID (ord_…).
numberstring or null
The order number shown to the customer.
createdAtstring
When the order was placed.
typestring
The kind of order. Unknown kinds show as new. One of new, renew, transfer, upgrade.
billingobject
The order total.
amountnumber
Order total in currencyCode.
currencyCodestring
ISO 4217 currency code, for example SEK.
billingCyclestring
Always monthly here. It does not say how the ordered products are billed.
itemsarray of object
The ordered items. When the order has no item details, one line carries the order total.
namestring
The item name.
amountnumber
Item amount in currencyCode.
currencyCodestring
ISO 4217 currency code, for example SEK.
invoiceobject | null
The order’s unpaid invoice.
idstring
The invoice ID (inv_…).
numberstring or null
The invoice number shown on the invoice.
totalnumber
Invoice total in currencyCode.
currencyCodestring
ISO 4217 currency code, for example SEK.
dueAtstring or null
When the invoice is due.

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.