curl --request GET \
--url https://console.advinservers.com/api/v1/client/servers/{server}/snapshots \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/servers/{server}/snapshots"
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}/snapshots', 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}/snapshots",
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}/snapshots"
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}/snapshots")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/servers/{server}/snapshots")
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": "2305595e-9b2f-4f9e-96d7-47fc7ff45791",
"name": "Pre-cascade baseline",
"status": "available",
"is_successful": true,
"is_available": true,
"size": 85899345920,
"disk_allocated": 85899345920,
"disk_used": 33822867456,
"completed_at": "2026-09-12T22:07:13.000000Z",
"created_at": "2026-09-12T22:05:47.000000Z",
"server": {
"uuid": "ecc6f4f1-c89b-4dce-a20b-a330641c5b0b",
"uuid_short": "ecc6f4f1",
"name": "lambda-core",
"windows": false,
"template_name": "Ubuntu 24.04",
"template_icon_url": "https://img.icons8.com/color/48/ubuntu.png"
},
"server_name": "lambda-core",
"storage": {
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"is_suspended": false
}
}
],
"storages": [
{
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"size_gb": 200,
"capacity": 214748364800,
"used": 85899345920,
"remaining": 128849018880,
"snapshots_count": 1,
"is_suspended": false,
"is_usable": true,
"billing": {
"service_id": 7436,
"invoice_id": 16388,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "3.00",
"currency": "USD",
"billing_cycle": "Monthly",
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-06-03T17:26:52+00:00"
},
"cancellation_type": null,
"cancellation_requested_at": null,
"autopay": false,
"can_cancel": false,
"can_resize": true,
"pending_resize": null,
"created_at": "2026-06-03T17:26:40+00:00"
}
],
"storage_available": 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": "The request could not be carried out."
}{
"message": "Too Many Attempts."
}List snapshots available to a server
Overview
Lists every snapshot in the server’s account and team, newest first, without pagination. This includes snapshots of other servers, and any of them can be restored onto this server. Each entry names the server the snapshot was taken of, while that server still exists. A snapshot being restored onto this server has the status restoring in this list only. The same snapshot can be restored onto other servers at the same time. The response also lists the team’s snapshot storages that can hold a new snapshot.
Permissions
Requires the snapshot.read (View snapshots) permission for the selected team. Resources outside that team return 404.
curl --request GET \
--url https://console.advinservers.com/api/v1/client/servers/{server}/snapshots \
--header 'Authorization: Bearer <token>'import requests
url = "https://console.advinservers.com/api/v1/client/servers/{server}/snapshots"
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}/snapshots', 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}/snapshots",
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}/snapshots"
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}/snapshots")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/servers/{server}/snapshots")
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": "2305595e-9b2f-4f9e-96d7-47fc7ff45791",
"name": "Pre-cascade baseline",
"status": "available",
"is_successful": true,
"is_available": true,
"size": 85899345920,
"disk_allocated": 85899345920,
"disk_used": 33822867456,
"completed_at": "2026-09-12T22:07:13.000000Z",
"created_at": "2026-09-12T22:05:47.000000Z",
"server": {
"uuid": "ecc6f4f1-c89b-4dce-a20b-a330641c5b0b",
"uuid_short": "ecc6f4f1",
"name": "lambda-core",
"windows": false,
"template_name": "Ubuntu 24.04",
"template_icon_url": "https://img.icons8.com/color/48/ubuntu.png"
},
"server_name": "lambda-core",
"storage": {
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"is_suspended": false
}
}
],
"storages": [
{
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"size_gb": 200,
"capacity": 214748364800,
"used": 85899345920,
"remaining": 128849018880,
"snapshots_count": 1,
"is_suspended": false,
"is_usable": true,
"billing": {
"service_id": 7436,
"invoice_id": 16388,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "3.00",
"currency": "USD",
"billing_cycle": "Monthly",
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-06-03T17:26:52+00:00"
},
"cancellation_type": null,
"cancellation_requested_at": null,
"autopay": false,
"can_cancel": false,
"can_resize": true,
"pending_resize": null,
"created_at": "2026-06-03T17:26:40+00:00"
}
],
"storage_available": 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": "The request could not be carried out."
}{
"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 snapshots, newest first.
Show child attributes
Show child attributes
[
{
"uuid": "2305595e-9b2f-4f9e-96d7-47fc7ff45791",
"name": "Pre-cascade baseline",
"status": "available",
"is_successful": true,
"is_available": true,
"size": 85899345920,
"disk_allocated": 85899345920,
"disk_used": 33822867456,
"completed_at": "2026-09-12T22:07:13.000000Z",
"created_at": "2026-09-12T22:05:47.000000Z",
"server": {
"uuid": "ecc6f4f1-c89b-4dce-a20b-a330641c5b0b",
"uuid_short": "ecc6f4f1",
"name": "lambda-core",
"windows": false,
"template_name": "Ubuntu 24.04",
"template_icon_url": "https://img.icons8.com/color/48/ubuntu.png"
},
"server_name": "lambda-core",
"storage": {
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"is_suspended": false
}
}
]
The usable snapshot storages in the team: paid for, not suspended and not ended.
Show child attributes
Show child attributes
[
{
"uuid": "9e83397b-d88e-43ae-bfb7-a8c2e6eda853",
"name": "Storage 1",
"status": "active",
"status_label": "Active",
"progress_message": null,
"needs_funds": false,
"size_gb": 200,
"capacity": 214748364800,
"used": 85899345920,
"remaining": 128849018880,
"snapshots_count": 1,
"is_suspended": false,
"is_usable": true,
"billing": {
"service_id": 7436,
"invoice_id": 16388,
"invoice_url": null,
"checkout_uuid": null,
"invoice_status": "Paid",
"amount": "3.00",
"currency": "USD",
"billing_cycle": "Monthly",
"payment_due_at": null,
"payment_window_minutes": 30,
"paid_at": "2026-06-03T17:26:52+00:00"
},
"cancellation_type": null,
"cancellation_requested_at": null,
"autopay": false,
"can_cancel": false,
"can_resize": true,
"pending_resize": null,
"created_at": "2026-06-03T17:26:40+00:00"
}
]
Whether this location can write a snapshot at all. Taking one is refused where this is false.
true