Orders
Orders endpoints for your Cloud API integration.
List orders
Paid orders are separate from VPS operations. Statuses: pending, processing, completed, failed, refunded, review. completed on a dedicated purchase means reserved, not issued. review means an uncertain or partial outcome that needs clarification; do not start a duplicate purchase. Parameters expose only public fields and never passwords or internal costs.
Order details
Paid orders are separate from VPS operations. Statuses: pending, processing, completed, failed, refunded, review. completed on a dedicated purchase means reserved, not issued. review means an uncertain or partial outcome that needs clarification; do not start a duplicate purchase. Parameters expose only public fields and never passwords or internal costs.
Order queue
Returns the creation queue for a VPS purchase belonging to this integration. Use the Cloud API order_id, not operation_id. status is the provisioning operation status: queued, running, succeeded, failed or cancelled; it differs from the billing order status. position is the order position among waiting purchases in the location/platform, or null outside the queue. waiting is the total waiting count across buyers. Counts may lag by up to five seconds; placement can skip orders that do not fit currently available resources. can_cancel=true means cancellation was possible when read, not a reservation of that right. reason can be node_busy, node_unavailable, ip_pool_exhausted, network_pool_empty or null. Returns 409 queue_not_ready before the order reaches provisioning; check GET /orders/{order_id} and retry while the order is pending or processing. Non-VPS purchases return 409 not_vm_purchase.
Cancel VPS queue
Cancels a queued VPS purchase before resource reservation or provisioning starts. Use the Cloud API order_id. The request has no body; api_key_id is a query parameter. No Idempotency-Key is needed: repeating DELETE for the same cancelled order returns the refunded order without another refund. HTTP 200 confirms cancellation and refund of the original charged amount to the integration balance. A zero-cost administrative order remains zero-cost. The order status is refunded with error_code=creation_cancelled; provisioning status is cancelled. Expect order.refunded and vm.creation_cancelled webhooks. Once provisioning starts, returns 409 queue_cancel_unavailable without a refund. Before dispatch, returns 409 queue_not_ready; non-VPS purchases return 409 not_vm_purchase. A 503 response does not prove cancellation failed: read the order and repeat the same DELETE. This route does not delete an issued VPS or cancel a dedicated rental.