List pending orders

GET /api/v2/me/pending-orders

Return the pending order, if any, that currently requires customer action.

There is no general GET /api/v2/orders collection endpoint; use this route for pending-order discovery, POST /api/v2/orders to create an order, and GET /api/v2/orders/{id} when another response already gave you an ord_... id.

Returns a bounded snapshot as { pendingOrders }, not a paginated data list: the array contains at most one entry — the most recent order that is pending, unpaid, created within the last 30 days, and eligible for BankID activation.

Older pending orders, orders whose invoice is already paid, and orders that cannot be activated with BankID are not included.

Account & Access Account

Authentication

Required API scope: read:orders

Authenticate with an API key in the Authorization: Bearer <token> header.

Context

Headers

Authorization Bearer <token>
Accept application/json

Responses

200 Pending-order snapshot.
pendingOrders array<object> required
pendingOrders[].id string required · Example: ord_01hxa3b4c5d6e7f8g9h0j1k2m3

Public order ID.

pendingOrders[].number string · nullable required

Human-facing order number when available.

pendingOrders[].createdAt string required

When the order was placed.

pendingOrders[].type string · enum required

Kind of order.

new
renew
transfer
upgrade
pendingOrders[].billing object required
pendingOrders[].billing.amount number required

Order total in the currency named by currencyCode.

pendingOrders[].billing.currencyCode string required

ISO 4217 currency code, e.g. SEK.

pendingOrders[].billing.billingCycle string required

Billing cycle of the order. Currently always monthly.

pendingOrders[].items array<object> required

Order line items. When no line detail is available a single synthesized line carries the order total.

pendingOrders[].items[].name string required

Line item name.

pendingOrders[].items[].amount number required

Line amount in the currency named by currencyCode.

pendingOrders[].items[].currencyCode string required

ISO 4217 currency code, e.g. SEK.

pendingOrders[].invoice object | null required

Linked unpaid invoice, or null when no invoice is linked.

pendingOrders[].invoice.id string required · Example: inv_01hxa3b4c5d6e7f8g9h0j1k2m3

Public invoice ID.

pendingOrders[].invoice.number string · nullable required

Human-facing invoice number when available.

pendingOrders[].invoice.total number required

Invoice total in the currency named by currencyCode.

pendingOrders[].invoice.currencyCode string required

ISO 4217 currency code, e.g. SEK.

pendingOrders[].invoice.dueAt string · nullable required

Invoice due date when available.

400 Invalid request. The response body is an RFC 7807 Problem Details document.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
401 Unauthorized. Authentication is required.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
403 Forbidden. The caller lacks a required scope or does not own the resource.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
404 Not found. The resource does not exist or is not owned by the caller.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
429 Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
500 Internal error. Retry later or contact support if the issue persists.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
GET https://cloud.hostup.se/api/v2/me/pending-orders
For AI assistants
View as Markdown
cURL 
curl -X GET "https://cloud.hostup.se/api/v2/me/pending-orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response 
// One activatable pending order
{
  "pendingOrders": [
    {
      "id": "ord_01hxa3b4c5d6e7f8g9h0j1k2m3",
      "number": "100234",
      "createdAt": "2026-07-01T09:30:00.000Z",
      "type": "new",
      "billing": {
        "amount": 249,
        "currencyCode": "SEK",
        "billingCycle": "monthly"
      },
      "items": [
        {
          "name": "Cloud VPS S",
          "amount": 249,
          "currencyCode": "SEK"
        }
      ],
      "invoice": {
        "id": "inv_01hxa3b4c5d6e7f8g9h0j1k2m3",
        "number": "102345",
        "total": 249,
        "currencyCode": "SEK",
        "dueAt": "2026-07-15T00:00:00.000Z"
      }
    }
  ]
}

// No activatable pending order
{
  "pendingOrders": []
}