# Orders

Orders

Create, list, inspect and cancel VPS orders.

POST/orders

Create a new server order. Returns the order object with provisioning status.

Request body

json

{
  "category": "dedicated",
  "cores": 4,
  "ram": 16,
  "disk": 240,
  "storage": "nvme",
  "bw": "5g",
  "loc": "fra",
  "os": "ubuntu-24.04",
  "billing_cycle": "hourly",
  "cloud_init": {
    "ci_user": "deploy",
    "ssh_keys": "ssh-ed25519 AAAA...",
    "password": "mysecretpass"
  }
}

Response 201

json

{
  "id": "ord_2vR9kP...",
  "server_id": "srv_4xKm9Q...",
  "status": "provisioning",
  "config": {
    "cores": 4,
    "ram": 16,
    "disk": 240,
    "storage": "nvme",
    "bw": "5g",
    "loc": "fra",
    "os": "ubuntu-24.04"
  },
  "price": {
    "hourly": 0.067861
  },
  "created_at": "2026-06-12T09:41:00Z"
}

category is one of shared, dedicated, or performance (see GET /tiers) — defaults to dedicated if omitted. Use bw format <number>g or <number>g-unmetered. Storage can be ssd or nvme. All orders are billed hourly — no other billing cycles exist. Send an X-Idempotency-Key header to make retries safe — the first response is replayed for 24h; a duplicate key that is still in flight returns 409 concurrent_request.

cloud_init is optional. All three sub-fields are optional: ci_user (lowercase, max 32 chars), ssh_keys (one or more public keys, newline-separated, max 16 KB), and password (8–128 chars, stored encrypted). If omitted, the OS image default credentials apply.

GET/orders

List your active server orders. Supports ?status=active|terminated|provisioning.

json

[
  {
    "id": "ord_2vR9kP...",
    "status": "active",
    "ipv4": "185.203.114.12",
    "config": { "cores": 4, "ram": 16, "loc": "fra", "os": "ubuntu-24.04" },
    "price": { "hourly": 0.067861 },
    "created_at": "2026-06-12T09:41:00Z"
  }
]

GET/orders/{id}

Get a single order by ID. Includes live status and assigned IP addresses.

json

{
  "id": "ord_2vR9kP...",
  "status": "active",
  "ipv4": "185.203.114.12",
  "config": { "cores": 4, "ram": 16, "loc": "fra", "os": "ubuntu-24.04" },
  "price": { "hourly": 0.067861 },
  "created_at": "2026-06-12T09:41:00Z",
  "ready_at": "2026-06-12T09:52:00Z"
}

DELETE/orders/{id}

Terminate a server. Billing stops immediately. This action is irreversible.

json

{
  "id": "ord_2vR9kP...",
  "status": "terminated",
  "terminated_at": "2026-06-12T14:22:00Z"
}