curl --request GET \
--url https://console.advinservers.com/api/v1/client/bandwidth-blocks \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/bandwidth-blocks"
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/bandwidth-blocks', 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/bandwidth-blocks",
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/bandwidth-blocks"
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/bandwidth-blocks")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/bandwidth-blocks")
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{
"items": [
{
"uuid": "23653478-238e-4db3-b263-91a221b5e7c2",
"region": "us_eu",
"region_label": "Americas & EMEA",
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"terabytes": 2,
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"assignment": "servers",
"servers": [
{
"id": "304e1794",
"uuid": "304e1794-a5b7-41f2-9a20-c0d444eb6683",
"name": "sector-c-db",
"hostname": "sector-c-db.blackmesa.example.com",
"template_name": "Debian 13",
"template_icon_url": "https://img.icons8.com/color/48/debian.png",
"windows": false,
"address": "203.0.113.57",
"location": "Kansas City, MO"
}
],
"servers_in_other_teams": 0,
"attachable_servers": 1,
"location": null,
"unit_price": "1.00",
"billing": {
"service_id": null,
"invoice_id": 17853,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "2.00",
"currency": "USD",
"billing_cycle": null,
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-08-20T11:26:19+00:00"
},
"can_cancel": true,
"created_at": "2026-08-20T11:26:14+00:00",
"cancellation_refund": "1.50",
"refund_amount": null,
"refund_pending": false
}
],
"totals": {
"blocks": 1,
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"pending": 0,
"by_region": {
"us_eu": {
"label": "Americas & EMEA",
"blocks": 1,
"size": 2199023255552,
"remaining": 1649267441664
},
"apac": {
"label": "APAC",
"blocks": 0,
"size": 0,
"remaining": 0
}
}
},
"pooled_locations": []
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "Too Many Attempts."
}List bandwidth blocks
Overview
Lists bandwidth blocks in the current team, newest first. Includes active blocks and pending purchases with status_label and progress_message. Blocks under billing review or with no remaining bandwidth are omitted. totals summarizes the listed blocks. pooled_locations lists the locations where the current team’s servers share an allowance.
Permissions
Requires the network.read (View networking) permission for the selected team. Resources outside that team return 404.
curl --request GET \
--url https://console.advinservers.com/api/v1/client/bandwidth-blocks \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/bandwidth-blocks"
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/bandwidth-blocks', 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/bandwidth-blocks",
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/bandwidth-blocks"
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/bandwidth-blocks")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/bandwidth-blocks")
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{
"items": [
{
"uuid": "23653478-238e-4db3-b263-91a221b5e7c2",
"region": "us_eu",
"region_label": "Americas & EMEA",
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"terabytes": 2,
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"assignment": "servers",
"servers": [
{
"id": "304e1794",
"uuid": "304e1794-a5b7-41f2-9a20-c0d444eb6683",
"name": "sector-c-db",
"hostname": "sector-c-db.blackmesa.example.com",
"template_name": "Debian 13",
"template_icon_url": "https://img.icons8.com/color/48/debian.png",
"windows": false,
"address": "203.0.113.57",
"location": "Kansas City, MO"
}
],
"servers_in_other_teams": 0,
"attachable_servers": 1,
"location": null,
"unit_price": "1.00",
"billing": {
"service_id": null,
"invoice_id": 17853,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "2.00",
"currency": "USD",
"billing_cycle": null,
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-08-20T11:26:19+00:00"
},
"can_cancel": true,
"created_at": "2026-08-20T11:26:14+00:00",
"cancellation_refund": "1.50",
"refund_amount": null,
"refund_pending": false
}
],
"totals": {
"blocks": 1,
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"pending": 0,
"by_region": {
"us_eu": {
"label": "Americas & EMEA",
"blocks": 1,
"size": 2199023255552,
"remaining": 1649267441664
},
"apac": {
"label": "APAC",
"blocks": 0,
"size": 0,
"remaining": 0
}
}
},
"pooled_locations": []
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"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.
Response
The record, as a JSON object. There is no envelope.
The blocks themselves. Every byte figure is a plain byte count.
Show child attributes
Show child attributes
[
{
"uuid": "23653478-238e-4db3-b263-91a221b5e7c2",
"region": "us_eu",
"region_label": "Americas & EMEA",
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"terabytes": 2,
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"assignment": "servers",
"servers": [
{
"id": "304e1794",
"uuid": "304e1794-a5b7-41f2-9a20-c0d444eb6683",
"name": "sector-c-db",
"hostname": "sector-c-db.blackmesa.example.com",
"template_name": "Debian 13",
"template_icon_url": "https://img.icons8.com/color/48/debian.png",
"windows": false,
"address": "203.0.113.57",
"location": "Kansas City, MO"
}
],
"servers_in_other_teams": 0,
"attachable_servers": 1,
"location": null,
"unit_price": "1.00",
"billing": {
"service_id": null,
"invoice_id": 17853,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "2.00",
"currency": "USD",
"billing_cycle": null,
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-08-20T11:26:19+00:00"
},
"can_cancel": true,
"created_at": "2026-08-20T11:26:14+00:00",
"cancellation_refund": "1.50",
"refund_amount": null,
"refund_pending": false
}
]
The same rows added up, overall and by region.
Show child attributes
Show child attributes
{
"blocks": 1,
"size": 2199023255552,
"consumed": 549755813888,
"remaining": 1649267441664,
"pending": 0,
"by_region": {
"us_eu": {
"label": "Americas & EMEA",
"blocks": 1,
"size": 2199023255552,
"remaining": 1649267441664
},
"apac": {
"label": "APAC",
"blocks": 0,
"size": 0,
"remaining": 0
}
}
}
The ids of the cities where the current team's servers share one budget.
[]