Skip to main content

Calculate VPS price

POST 

/vms/quote

Choose a plan, location and OS from the catalog. For a normal installation, supply exactly one of password or ssh_public_key, including in the quote request. The SSH key is a single OpenSSH public-key line (Ed25519, RSA or ECDSA). cpu_percent defaults to 60, months to 1 and auto_renew to false. api_user_id is your own customer identifier.

This calculation creates no order, charge or reservation. It can be called with an insufficient balance. Use amount_usd as expected_amount_usd when confirming the purchase.

Request rules and errors · Lifecycle · Webhooks

Optional cloud-config JSON object, not a YAML string. Maximum 65536 bytes after server JSON serialization (non-ASCII characters are escaped). users, packages, runcmd and write_files must be arrays when present. Networking, hostname and primary access are managed by the platform. Retain the same object when retrying. Its result is reported separately in guest_initialization; cloud_init contents are not returned in orders or webhooks.

Latest installation result: succeeded means cloud-init finished; failed / cloud_init_failed means custom configuration failed; unknown / guest_initialization_timeout means the result was not confirmed within 15 minutes. failed and unknown do not mean a running VPS was not created: its order may be completed and reinstallation succeeded. null means no result is available. Does not confirm application health.

Optional application_id selects an application from GET /reference/applications. Keep os_id and exactly one access method. Do not combine application_id with a non-null cloud_init, including {}. Availability, OS and resource compatibility are checked during provisioning by the server service; Cloud API does not duplicate those checks. A rejected creation is handled by the existing order refund flow. Quotes calculate the VPS price only and do not confirm application compatibility. Applications do not add a separate charge. Keep application_id unchanged when retrying the same Idempotency-Key.

Windows VPS use the same endpoint and an os_id from GET /reference/os. New Windows installations use login admin; Linux uses root. Windows requires password (8–127 characters, at least three of lowercase, uppercase, digits and special characters; no CR, LF or NUL and no login substring). Do not supply ssh_public_key, application_id or non-null cloud_init, including {}. A Windows hostname must be at most 15 characters and cannot contain only digits. OS/template/resource compatibility is checked by the server service during provisioning; a quote does not confirm it. Rejected creation follows the existing order refund flow.

To create a new VPS from a paid backup, supply backup_id instead of os_id. Omit password, ssh_public_key, application_id and cloud_init: OS, programs and access come from the copy. Keep the same api_user_id as the backup owner. The new VPS receives its own addresses and is billed as a normal vm_purchase with the usual plan markup and term discount. Restore itself has no separate fee and shares the 3-per-service/24-hour restore limit. The selected disk must fit all backed-up disks; compatibility is checked by the server service.

Request​

Responses​

Successful response

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