Skip to main content

Orders

Orders endpoints for your Cloud API integration.

📄️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.

© 2026 AdaptGroup LLC. All rights reserved.
30 N Gould St Ste R, Sheridan, WY 82801, USA
Back to top