curl --request GET \
--url https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog', 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/{server}/upgrades/catalog",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"enabled": true,
"currency": "USD",
"current_location_id": 3,
"current_group_id": "2",
"current_disk": 85899345920,
"disk_resize_required": false,
"migration_allowed": true,
"has_attached_floating_ips": false,
"location_change_fee": "5.00",
"product_change_fee": "2.50",
"groups": [
{
"id": "2",
"name": "Standard VPS",
"description": "NVMe storage, DDR5 memory and a 10 Gbps port on every plan.",
"subtext": null,
"speed": "10 Gbps",
"ddr5": true,
"locations": [
{
"id": "2-3",
"display_name": "Kansas City, MO",
"name": "Kansas City, MO",
"flag_url": null,
"cid": 3,
"group_name": "Standard VPS",
"location_id": 3,
"product_group_id": 2,
"plans": [
{
"key": "84ee2bf7fc22f495e76aead064154e1d5ae66fee1ac71cda7cf48d9e607a60bc",
"id": "standard-8gb",
"name": "Standard 8 GB",
"vcpu_cores": 6,
"memory": 8000,
"disk": 160,
"bandwidth": 10000,
"hdd": false,
"primary_disk": 160,
"hdd_disk": 0,
"price": "22.00",
"deployment_time": "Instant",
"whmcs_id": "49",
"available": true,
"whmcs_url": "https://clients.advinservers.com/cart.php?a=add&pid=49",
"unavailable_reason": null,
"available_with_disk_resize": true,
"unavailable_with_disk_resize_reason": null
}
],
"is_current": true
}
]
}
]
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "Not found."
}{
"message": "Too Many Attempts."
}List upgrade plans for a server
Overview
Lists available upgrade plans, grouped by product and location. current_group_id and current_location_id identify the current plan’s group and location. current_disk is the current disk size. disk_resize_required indicates whether the disk must grow, and migration_allowed indicates whether the server can move to another location. has_attached_floating_ips indicates that a floating IP is attached; plans in another location are still listed, but quoting one is refused until the floating IPs are detached.
A plan listed as available can still be quoted for ten minutes after the catalogue was read, even if the capacity it was listed on is taken in the meantime.
location_change_fee and product_change_fee are the fixed fees for changing location or product group. Use these to show fees before requesting a quote. When upgrades are unavailable, enabled is false and no plans are returned.
Permissions
Requires the server.read (View servers) permission for the selected team. Resources outside that team return 404.
curl --request GET \
--url https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog', 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/{server}/upgrades/catalog",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/servers/{server}/upgrades/catalog")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"enabled": true,
"currency": "USD",
"current_location_id": 3,
"current_group_id": "2",
"current_disk": 85899345920,
"disk_resize_required": false,
"migration_allowed": true,
"has_attached_floating_ips": false,
"location_change_fee": "5.00",
"product_change_fee": "2.50",
"groups": [
{
"id": "2",
"name": "Standard VPS",
"description": "NVMe storage, DDR5 memory and a 10 Gbps port on every plan.",
"subtext": null,
"speed": "10 Gbps",
"ddr5": true,
"locations": [
{
"id": "2-3",
"display_name": "Kansas City, MO",
"name": "Kansas City, MO",
"flag_url": null,
"cid": 3,
"group_name": "Standard VPS",
"location_id": 3,
"product_group_id": 2,
"plans": [
{
"key": "84ee2bf7fc22f495e76aead064154e1d5ae66fee1ac71cda7cf48d9e607a60bc",
"id": "standard-8gb",
"name": "Standard 8 GB",
"vcpu_cores": 6,
"memory": 8000,
"disk": 160,
"bandwidth": 10000,
"hdd": false,
"primary_disk": 160,
"hdd_disk": 0,
"price": "22.00",
"deployment_time": "Instant",
"whmcs_id": "49",
"available": true,
"whmcs_url": "https://clients.advinservers.com/cart.php?a=add&pid=49",
"unavailable_reason": null,
"available_with_disk_resize": true,
"unavailable_with_disk_resize_reason": null
}
],
"is_current": true
}
]
}
]
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "Not found."
}{
"message": "Too Many Attempts."
}Authorizations
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.
Path Parameters
The server UUID
"ecc6f4f1"
Response
The record, as a JSON object. There is no envelope.
The value of enabled.
true
The three-letter currency code used for monetary amounts.
"USD"
The current location id ID.
3
The current group id ID.
"2"
Current primary disk capacity in bytes.
85899345920
The value of disk_resize_required.
false
The value of migration_allowed.
true
Whether the resource has attached floating ips.
false
The value of location_change_fee.
"5.00"
The value of product_change_fee.
"2.50"
The value of groups.
Show child attributes
Show child attributes
[
{
"id": "2",
"name": "Standard VPS",
"description": "NVMe storage, DDR5 memory and a 10 Gbps port on every plan.",
"subtext": null,
"speed": "10 Gbps",
"ddr5": true,
"locations": [
{
"id": "2-3",
"display_name": "Kansas City, MO",
"name": "Kansas City, MO",
"flag_url": null,
"cid": 3,
"group_name": "Standard VPS",
"location_id": 3,
"product_group_id": 2,
"plans": [
{
"key": "84ee2bf7fc22f495e76aead064154e1d5ae66fee1ac71cda7cf48d9e607a60bc",
"id": "standard-8gb",
"name": "Standard 8 GB",
"vcpu_cores": 6,
"memory": 8000,
"disk": 160,
"bandwidth": 10000,
"hdd": false,
"primary_disk": 160,
"hdd_disk": 0,
"price": "22.00",
"deployment_time": "Instant",
"whmcs_id": "49",
"available": true,
"whmcs_url": "https://clients.advinservers.com/cart.php?a=add&pid=49",
"unavailable_reason": null,
"available_with_disk_resize": true,
"unavailable_with_disk_resize_reason": null
}
],
"is_current": true
}
]
}
]