Skip to content
HostupDevelopers
GuidesAPI referenceSupport

List open orders

GET /api/v2/me/open-orders

Lists your recent orders that are still being set up or still waiting for payment. An order is included when it is from the last 14 days and has a line that is still pending or an unpaid invoice. Cancelled orders, renewals and upgrades are left out. Returns at most 5 orders, newest first. The list is not paginated. Each order has its invoice and one line per ordered item, with the item’s state and the ID of what it created. For the full order, use GET /api/v2/orders/{id}.

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

Example

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

Responses

200 Your open orders, newest first.

Response 200
{
  "openOrders": [
    {
      "id": "ord_01hxa3b4c5d6e7f8g9h0j1k2m3",
      "number": "1117145835",
      "createdAt": "2026-09-15T10:12:00.000Z",
      "invoice": {
        "id": "inv_01hxa3b4c5d6e7f8g9h0j1k2m3",
        "number": "202689534",
        "status": "paid",
        "total": 588,
        "currencyCode": "SEK",
        "dueAt": "2026-09-22T00:00:00.000Z"
      },
      "lines": [
        {
          "key": "example.com",
          "kind": "transfer",
          "label": "Example Label",
          "status": "pending",
          "started": true,
          "resource": {
            "type": "domain",
            "id": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3"
          },
          "attention": null
        },
        {
          "key": "hosting:1",
          "kind": "hosting",
          "label": "Example Label",
          "status": "active",
          "started": false,
          "resource": {
            "type": "account",
            "id": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3"
          },
          "attention": null
        }
      ]
    }
  ]
}
Response fields
openOrdersarray of object
Orders still being set up or still unpaid. At most 5.
idstring
The order ID (ord_…).
numberstring or null
The order number shown to the customer.
createdAtstring or null
When the order was placed.
invoiceobject or null
The order’s invoice. Null when the order has no invoice.
linesarray of object
One line per ordered item.
keystring
Identifies the line within the order: the domain name for a domain line, otherwise a key such as hosting:…. Treat it as opaque.
kindstring
What the line is: a domain register or transfer, hosting (web hosting), vps, an addon or other. One of transfer, register, hosting, vps, addon, other.
labelstring
The domain, hostname or product name as the customer sees it.
statusstring
pending: being registered, transferred or set up. active: live. failed: could not be set up. closed: cancelled or ended. One of pending, active, failed, closed.
startedboolean
True when work on this pending line has begun, even while the invoice is unpaid. Always false when status is not pending.
resourceobject or null
What the line created. Null until it exists.
attentionstring or null
Set when a domain registration or transfer failed and the customer must act. The domain’s page in the client area shows what to do. One of registration_failed, transfer_failed.

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.

This page as MarkdownOpenAPI spec