Order servers

curl --request POST \
  --url https://console.advinservers.com/api/v1/client/servers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quote_token": "eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0",
  "quantity": 1,
  "hostname": null,
  "hostnames": [
    "hev-telemetry.blackmesa.example.com"
  ],
  "labels": [
    "hev-telemetry"
  ],
  "label": null,
  "template_uuid": "e28b39a8-059e-4a75-8048-c9a6e7231b9f",
  "account_password": "Resonance-Cascade-1998",
  "ssh_keys": [
    "97721fd4-746a-40cc-8da0-4c9f623c112e"
  ],
  "user_script": "8edb21bc-9aee-4bd9-8a02-17043fa82a87"
}
'

import requests

url = "https://console.advinservers.com/api/v1/client/servers"

payload = {
    "quote_token": "eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0",
    "quantity": 1,
    "hostname": None,
    "hostnames": ["hev-telemetry.blackmesa.example.com"],
    "labels": ["hev-telemetry"],
    "label": None,
    "template_uuid": "e28b39a8-059e-4a75-8048-c9a6e7231b9f",
    "account_password": "Resonance-Cascade-1998",
    "ssh_keys": ["97721fd4-746a-40cc-8da0-4c9f623c112e"],
    "user_script": "8edb21bc-9aee-4bd9-8a02-17043fa82a87"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    quote_token: 'eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0',
    quantity: 1,
    hostname: null,
    hostnames: ['hev-telemetry.blackmesa.example.com'],
    labels: ['hev-telemetry'],
    label: null,
    template_uuid: 'e28b39a8-059e-4a75-8048-c9a6e7231b9f',
    account_password: 'Resonance-Cascade-1998',
    ssh_keys: ['97721fd4-746a-40cc-8da0-4c9f623c112e'],
    user_script: '8edb21bc-9aee-4bd9-8a02-17043fa82a87'
  })
};

fetch('https://console.advinservers.com/api/v1/client/servers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://console.advinservers.com/api/v1/client/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'quote_token' => 'eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0',
    'quantity' => 1,
    'hostname' => null,
    'hostnames' => [
        'hev-telemetry.blackmesa.example.com'
    ],
    'labels' => [
        'hev-telemetry'
    ],
    'label' => null,
    'template_uuid' => 'e28b39a8-059e-4a75-8048-c9a6e7231b9f',
    'account_password' => 'Resonance-Cascade-1998',
    'ssh_keys' => [
        '97721fd4-746a-40cc-8da0-4c9f623c112e'
    ],
    'user_script' => '8edb21bc-9aee-4bd9-8a02-17043fa82a87'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://console.advinservers.com/api/v1/client/servers"

	payload := strings.NewReader("{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/servers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://console.advinservers.com/api/v1/client/servers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}"

response = http.request(request)
puts response.read_body

{
  "uuid": "a930b81e-663e-4e12-a437-001f207d5ac6",
  "status": "pending",
  "status_label": "Provisioning",
  "progress_message": null,
  "amount": "12.00",
  "currency": "USD",
  "quantity": 1,
  "orders": [
    {
      "uuid": "0e6a7712-98ab-451b-8675-5c5ae96e4d3a",
      "purchase_uuid": "a930b81e-663e-4e12-a437-001f207d5ac6",
      "purchase_status": "pending",
      "status": "pending_payment",
      "status_label": "Provisioning",
      "is_placed": false,
      "progress_message": null,
      "plan_name": "Standard 4 GB",
      "plan_key": "032f97c3b0f718ae9a2edfba83d5adf321025b5d9af1e90d397e79b8667bb3a4",
      "vcpu_cores": 4,
      "memory": 4000,
      "disk": 80,
      "bandwidth": 5000,
      "hdd": false,
      "location": "Kansas City, MO",
      "location_id": 3,
      "group_name": "Standard VPS",
      "hostname": "hev-telemetry.blackmesa.example.com",
      "label": "hev-telemetry",
      "template_name": "Ubuntu 24.04",
      "template_icon_url": "https://img.icons8.com/color/48/ubuntu.png",
      "billing": {
        "service_id": null,
        "invoice_id": null,
        "invoice_url": null,
        "checkout_uuid": null,
        "invoice_status": null,
        "amount": "12.00",
        "currency": "USD",
        "billing_cycle": "monthly",
        "payment_due_at": null,
        "payment_window_minutes": 30,
        "paid_at": null
      },
      "server_id": null,
      "can_cancel": true,
      "created_at": "2026-09-14T16:31:47+00:00"
    }
  ],
  "created_at": "2026-09-14T16:31:47+00:00"
}

{
  "message": "Unauthenticated."
}

{
  "message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}

{
  "message": "The name field is required.",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

Servers

Order servers

Overview

Orders servers using one quoted plan. Send quote_token and quantity from 1 to 10 with a matching hostnames list, or one hostname for a single server. Any hostname may be left blank, and the machine is then named after the IP address it is deployed onto. A matching labels list sets the panel display name of each server; any label left blank is randomly generated. Include the operating system, password and any SSH keys or setup script. Returns the purchase with one order per server. Payment from account credit and installation run in the background. Poll the outstanding orders for their status and server ID. Insufficient credit sets needs_funds until funds arrive or the payment deadline expires. Failed paid installations are refunded to account credit.

Permissions

Requires the billing.purchase (Make purchases) permission for the selected team. Resources outside that team return 404.

POST

servers

Order servers

curl --request POST \
  --url https://console.advinservers.com/api/v1/client/servers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quote_token": "eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0",
  "quantity": 1,
  "hostname": null,
  "hostnames": [
    "hev-telemetry.blackmesa.example.com"
  ],
  "labels": [
    "hev-telemetry"
  ],
  "label": null,
  "template_uuid": "e28b39a8-059e-4a75-8048-c9a6e7231b9f",
  "account_password": "Resonance-Cascade-1998",
  "ssh_keys": [
    "97721fd4-746a-40cc-8da0-4c9f623c112e"
  ],
  "user_script": "8edb21bc-9aee-4bd9-8a02-17043fa82a87"
}
'

import requests

url = "https://console.advinservers.com/api/v1/client/servers"

payload = {
    "quote_token": "eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0",
    "quantity": 1,
    "hostname": None,
    "hostnames": ["hev-telemetry.blackmesa.example.com"],
    "labels": ["hev-telemetry"],
    "label": None,
    "template_uuid": "e28b39a8-059e-4a75-8048-c9a6e7231b9f",
    "account_password": "Resonance-Cascade-1998",
    "ssh_keys": ["97721fd4-746a-40cc-8da0-4c9f623c112e"],
    "user_script": "8edb21bc-9aee-4bd9-8a02-17043fa82a87"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    quote_token: 'eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0',
    quantity: 1,
    hostname: null,
    hostnames: ['hev-telemetry.blackmesa.example.com'],
    labels: ['hev-telemetry'],
    label: null,
    template_uuid: 'e28b39a8-059e-4a75-8048-c9a6e7231b9f',
    account_password: 'Resonance-Cascade-1998',
    ssh_keys: ['97721fd4-746a-40cc-8da0-4c9f623c112e'],
    user_script: '8edb21bc-9aee-4bd9-8a02-17043fa82a87'
  })
};

fetch('https://console.advinservers.com/api/v1/client/servers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://console.advinservers.com/api/v1/client/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'quote_token' => 'eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0',
    'quantity' => 1,
    'hostname' => null,
    'hostnames' => [
        'hev-telemetry.blackmesa.example.com'
    ],
    'labels' => [
        'hev-telemetry'
    ],
    'label' => null,
    'template_uuid' => 'e28b39a8-059e-4a75-8048-c9a6e7231b9f',
    'account_password' => 'Resonance-Cascade-1998',
    'ssh_keys' => [
        '97721fd4-746a-40cc-8da0-4c9f623c112e'
    ],
    'user_script' => '8edb21bc-9aee-4bd9-8a02-17043fa82a87'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://console.advinservers.com/api/v1/client/servers"

	payload := strings.NewReader("{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/servers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://console.advinservers.com/api/v1/client/servers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quote_token\": \"eyJ2ZXJzaW9uIjoxLCJub25jZSI6IjNmYWRiNjgyM2ZmZTkyY2Q0ZDkwYzRkNjg4YTdjZWY5ZjBiYjBjZDE1YjVhM2VlMGE2MzMyZmU1YmQ4Njg1YWYiLCJvd25lcl9pZCI6MTg3Mywib3duZXJfZW1haWwiOiJnb3Jkb24uZnJlZW1hbkBibGFja21lc2EuZXhhbXBsZS5jb20iLCJleHBpcmVzX2F0IjoxNzg5NDA0NzI5LCJ3aG1jc19jb25maWd1cmF0aW9uX2ZpbmdlcnByaW50IjoiZTY3ZDIzZTc4MjBjNDlhOCJ9.f84ed5bfb2e3e24710926d5ccf5902fc93d0c9a0a45365dd784e1aa72d4083f0\",\n  \"quantity\": 1,\n  \"hostname\": null,\n  \"hostnames\": [\n    \"hev-telemetry.blackmesa.example.com\"\n  ],\n  \"labels\": [\n    \"hev-telemetry\"\n  ],\n  \"label\": null,\n  \"template_uuid\": \"e28b39a8-059e-4a75-8048-c9a6e7231b9f\",\n  \"account_password\": \"Resonance-Cascade-1998\",\n  \"ssh_keys\": [\n    \"97721fd4-746a-40cc-8da0-4c9f623c112e\"\n  ],\n  \"user_script\": \"8edb21bc-9aee-4bd9-8a02-17043fa82a87\"\n}"

response = http.request(request)
puts response.read_body

{
  "uuid": "a930b81e-663e-4e12-a437-001f207d5ac6",
  "status": "pending",
  "status_label": "Provisioning",
  "progress_message": null,
  "amount": "12.00",
  "currency": "USD",
  "quantity": 1,
  "orders": [
    {
      "uuid": "0e6a7712-98ab-451b-8675-5c5ae96e4d3a",
      "purchase_uuid": "a930b81e-663e-4e12-a437-001f207d5ac6",
      "purchase_status": "pending",
      "status": "pending_payment",
      "status_label": "Provisioning",
      "is_placed": false,
      "progress_message": null,
      "plan_name": "Standard 4 GB",
      "plan_key": "032f97c3b0f718ae9a2edfba83d5adf321025b5d9af1e90d397e79b8667bb3a4",
      "vcpu_cores": 4,
      "memory": 4000,
      "disk": 80,
      "bandwidth": 5000,
      "hdd": false,
      "location": "Kansas City, MO",
      "location_id": 3,
      "group_name": "Standard VPS",
      "hostname": "hev-telemetry.blackmesa.example.com",
      "label": "hev-telemetry",
      "template_name": "Ubuntu 24.04",
      "template_icon_url": "https://img.icons8.com/color/48/ubuntu.png",
      "billing": {
        "service_id": null,
        "invoice_id": null,
        "invoice_url": null,
        "checkout_uuid": null,
        "invoice_status": null,
        "amount": "12.00",
        "currency": "USD",
        "billing_cycle": "monthly",
        "payment_due_at": null,
        "payment_window_minutes": 30,
        "paid_at": null
      },
      "server_id": null,
      "can_cancel": true,
      "created_at": "2026-09-14T16:31:47+00:00"
    }
  ],
  "created_at": "2026-09-14T16:31:47+00:00"
}

{
  "message": "Unauthenticated."
}

{
  "message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}

{
  "message": "The name field is required.",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

Authorizations

Authorization

string

header

required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Body

application/json

Send a JSON object containing the fields below. Required fields are marked in the schema.

quote_token

string

required

The value of quote_token.

Maximum string length: 20000

quantity

integer

required

The value of quantity.

Required range: 1 <= x <= 10

hostnames

(string | null)[]

required

The value of hostnames.

Required array length: 1 element

Maximum string length: 191

template_uuid

string

required

The template uuid UUID.

account_password

string

required

The value of account_password.

Required string length: 5 - 191

hostname

string | null

The fully qualified hostname.

Maximum string length: 191

labels

(string | null)[]

The value of labels.

Required array length: 1 element

Maximum string length: 40

label

string | null

A short label shown to customers.

Maximum string length: 40

ssh_keys

string[]

The value of ssh_keys.

Maximum array length: 25

Required string length: 36

user_script

string | null

The value of user_script.

Required string length: 36

Response

The record, as a JSON object. There is no envelope.

A server purchase with its cost, payment status and orders.

uuid

string

required

The uuid UUID.

Example:

"a930b81e-663e-4e12-a437-001f207d5ac6"

status

enum<string>

required

The value of status.

Available options:

pending,

needs_funds,

paid,

refused,

expired,

cancelled

Example:

"needs_funds"

status_label

string

required

The value of status_label.

Example:

"Needs funds"

progress_message

string | null

required

The value of progress_message.

Example:

"Your balance is 2.00 USD short of the 12.00 USD this order costs. Add funds to continue."

amount

string

required

The whole purchase, as a decimal string in currency.

Example:

"12.00"

currency

string

required

The three-letter currency code used for monetary amounts.

Example:

"USD"

quantity

integer

required

The value of quantity.

Example:

1

orders

ServerOrderData · object[]

required

The value of orders.

Show child attributes

Example:

[
  {
    "uuid": "0e6a7712-98ab-451b-8675-5c5ae96e4d3a",
    "purchase_uuid": "a930b81e-663e-4e12-a437-001f207d5ac6",
    "purchase_status": "needs_funds",
    "status": "pending_payment",
    "status_label": "Needs funds",
    "is_placed": false,
    "progress_message": "Your balance is 2.00 USD short of the 12.00 USD this order costs. Add funds to continue.",
    "plan_name": "Standard 4 GB",
    "plan_key": "032f97c3b0f718ae9a2edfba83d5adf321025b5d9af1e90d397e79b8667bb3a4",
    "vcpu_cores": 4,
    "memory": 4000,
    "disk": 80,
    "bandwidth": 5000,
    "hdd": false,
    "location": "Kansas City, MO",
    "location_id": 3,
    "group_name": "Standard VPS",
    "hostname": "hev-telemetry.blackmesa.example.com",
    "label": "hev-telemetry",
    "template_name": "Ubuntu 24.04",
    "template_icon_url": "https://img.icons8.com/color/48/ubuntu.png",
    "billing": {
      "service_id": null,
      "invoice_id": null,
      "invoice_url": null,
      "checkout_uuid": null,
      "invoice_status": null,
      "amount": "12.00",
      "currency": "USD",
      "billing_cycle": "monthly",
      "payment_due_at": "2026-09-14T17:01:47+00:00",
      "payment_window_minutes": 30,
      "paid_at": null
    },
    "server_id": null,
    "can_cancel": true,
    "created_at": "2026-09-14T16:31:47+00:00"
  }
]

created_at

string | null

required

The date and time for created at, in UTC.

Example:

"2026-09-14T16:31:47+00:00"

Getting Started

Endpoints

Order servers

Overview

Permissions

Authorizations

Body

Response