curl --request GET \
--url https://console.vast.ai/api/v0/instances/ \
--header 'Authorization: Bearer <token>'{
"instances_found": 11,
"instances": [
{
"id": 312,
"actual_status": "running",
"cur_state": "running",
"next_state": "running",
"intended_status": "running",
"label": "ML Training Job 2025",
"template_id": 2048,
"template_hash_id": "abcde12345",
"template_name": "Tensorflow GPU Template",
"image_uuid": "nvidia/cuda:11.0.3-devel-ubuntu18.04",
"image_args": [
"bash",
"-c",
"apt update; apt install -y wget libpci3 xz-utils; wget ..."
],
"image_runtype": "ssh ssh_direc ssh_proxy",
"extra_env": [
[
"DOG",
"CAT"
],
[
"-p 70001:70001",
"1"
],
[
"-p 70002:70002",
"1"
]
],
"onstart": "echo 'hello'; echo $DOG; echo 'goodbye';",
"jupyter_token": "df77e27085bd4b3bd5d9024bdefb9e6df614b27adb0689e9d8f066fce5e01f0c",
"status_msg": "success, running nvidia/cuda_11.0.3-devel-ubuntu18.04/ssh",
"public_ipaddr": "192.0.2.45",
"local_ipaddrs": "10.0.0.5 172.17.0.2",
"ssh_host": "ssh123.vast.ai",
"ssh_idx": "6",
"ssh_port": 10600,
"machine_dir_ssh_port": 21000,
"machine_id": 12,
"start_date": 1668804745.1223178,
"end_date": 1735689600,
"uptime_mins": null,
"duration": -25323348.860099316,
"cpu_arch": "amd64",
"cpu_cores": 4,
"cpu_cores_effective": 4,
"cpu_name": "Core™ i5-6500",
"cpu_ram": 15989,
"cpu_util": 0,
"mem_limit": 15.71815424,
"mem_usage": 0.00996352,
"vmem_usage": 0.543945,
"gpu_name": "GTX 1070",
"gpu_arch": "nvidia",
"gpu_totalram": 16222,
"gpu_ram": 8111,
"gpu_util": 0,
"gpu_temp": 38.999981,
"gpu_frac": 1,
"gpu_lanes": 16,
"gpu_mem_bw": 187.1,
"bw_nvlink": 0,
"disk_name": "Seagate ST4000DM000",
"disk_space": 10.08,
"disk_bw": 159.98852679060644,
"disk_util": 0.05400000140070915,
"disk_usage": 0.05400000140070915,
"direct_port_count": 1001,
"direct_port_start": 20000,
"direct_port_end": 20002,
"ports": {
"8888/tcp": [
{
"HostIp": "0.0.0.0",
"HostPort": "8888"
}
],
"22/tcp": [
{
"HostIp": "0.0.0.0",
"HostPort": "20000"
}
]
},
"static_ip": false,
"geolocation": "California, United States",
"verification": "verified",
"rentable": true,
"host_id": 7,
"min_bid": 0.296,
"is_bid": false,
"dph_base": 0.8,
"dph_total": 0.8021,
"dlperf": null,
"dlperf_per_dphtotal": null,
"flops_per_dphtotal": 15.41170427627478,
"total_flops": 12.361728000000001,
"score": null,
"reliability2": 0.9686655,
"os_version": null,
"mobo_name": "Z170M Extreme4",
"pci_gen": 3,
"pcie_bw": 11.6,
"num_gpus": 2,
"webpage": null,
"search": {
"gpuCostPerHour": 0.8,
"diskHour": 0.0021,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.8013181279189862
},
"instance": {
"gpuCostPerHour": 0.8,
"diskHour": 0.001318127918986086,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.5034620970565428
},
"storage_cost": 0.15,
"storage_total_cost": 0.0021,
"vram_costperhour": 0.00004944519787942301,
"credit_balance": 4792.991450253207,
"credit_discount": 0.3723200385780543,
"credit_discount_max": 0.4,
"client_run_time": 100000000,
"host_run_time": 1,
"external": false,
"time_remaining": "12 Mon 24 D 16 Hr",
"time_remaining_isbid": "11 Mon 26 D 6 Hr",
"country_code": null,
"volume_info": []
}
]
}Retrieve a list of instances for the authenticated user.
CLI Usage: vastai show instances [OPTIONS] [--api-key API_KEY] [--raw]
curl --request GET \
--url https://console.vast.ai/api/v0/instances/ \
--header 'Authorization: Bearer <token>'{
"instances_found": 11,
"instances": [
{
"id": 312,
"actual_status": "running",
"cur_state": "running",
"next_state": "running",
"intended_status": "running",
"label": "ML Training Job 2025",
"template_id": 2048,
"template_hash_id": "abcde12345",
"template_name": "Tensorflow GPU Template",
"image_uuid": "nvidia/cuda:11.0.3-devel-ubuntu18.04",
"image_args": [
"bash",
"-c",
"apt update; apt install -y wget libpci3 xz-utils; wget ..."
],
"image_runtype": "ssh ssh_direc ssh_proxy",
"extra_env": [
[
"DOG",
"CAT"
],
[
"-p 70001:70001",
"1"
],
[
"-p 70002:70002",
"1"
]
],
"onstart": "echo 'hello'; echo $DOG; echo 'goodbye';",
"jupyter_token": "df77e27085bd4b3bd5d9024bdefb9e6df614b27adb0689e9d8f066fce5e01f0c",
"status_msg": "success, running nvidia/cuda_11.0.3-devel-ubuntu18.04/ssh",
"public_ipaddr": "192.0.2.45",
"local_ipaddrs": "10.0.0.5 172.17.0.2",
"ssh_host": "ssh123.vast.ai",
"ssh_idx": "6",
"ssh_port": 10600,
"machine_dir_ssh_port": 21000,
"machine_id": 12,
"start_date": 1668804745.1223178,
"end_date": 1735689600,
"uptime_mins": null,
"duration": -25323348.860099316,
"cpu_arch": "amd64",
"cpu_cores": 4,
"cpu_cores_effective": 4,
"cpu_name": "Core™ i5-6500",
"cpu_ram": 15989,
"cpu_util": 0,
"mem_limit": 15.71815424,
"mem_usage": 0.00996352,
"vmem_usage": 0.543945,
"gpu_name": "GTX 1070",
"gpu_arch": "nvidia",
"gpu_totalram": 16222,
"gpu_ram": 8111,
"gpu_util": 0,
"gpu_temp": 38.999981,
"gpu_frac": 1,
"gpu_lanes": 16,
"gpu_mem_bw": 187.1,
"bw_nvlink": 0,
"disk_name": "Seagate ST4000DM000",
"disk_space": 10.08,
"disk_bw": 159.98852679060644,
"disk_util": 0.05400000140070915,
"disk_usage": 0.05400000140070915,
"direct_port_count": 1001,
"direct_port_start": 20000,
"direct_port_end": 20002,
"ports": {
"8888/tcp": [
{
"HostIp": "0.0.0.0",
"HostPort": "8888"
}
],
"22/tcp": [
{
"HostIp": "0.0.0.0",
"HostPort": "20000"
}
]
},
"static_ip": false,
"geolocation": "California, United States",
"verification": "verified",
"rentable": true,
"host_id": 7,
"min_bid": 0.296,
"is_bid": false,
"dph_base": 0.8,
"dph_total": 0.8021,
"dlperf": null,
"dlperf_per_dphtotal": null,
"flops_per_dphtotal": 15.41170427627478,
"total_flops": 12.361728000000001,
"score": null,
"reliability2": 0.9686655,
"os_version": null,
"mobo_name": "Z170M Extreme4",
"pci_gen": 3,
"pcie_bw": 11.6,
"num_gpus": 2,
"webpage": null,
"search": {
"gpuCostPerHour": 0.8,
"diskHour": 0.0021,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.8013181279189862
},
"instance": {
"gpuCostPerHour": 0.8,
"diskHour": 0.001318127918986086,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.5034620970565428
},
"storage_cost": 0.15,
"storage_total_cost": 0.0021,
"vram_costperhour": 0.00004944519787942301,
"credit_balance": 4792.991450253207,
"credit_discount": 0.3723200385780543,
"credit_discount_max": 0.4,
"client_run_time": 100000000,
"host_run_time": 1,
"external": false,
"time_remaining": "12 Mon 24 D 16 Hr",
"time_remaining_isbid": "11 Mon 26 D 6 Hr",
"country_code": null,
"volume_info": []
}
]
}API key must be provided in the Authorization header
Success response with user instances
Number of instances found for the user.
11
List of instance objects.
Show child attributes
312
"running"
"running"
"running"
"running"
"ML Training Job 2025"
2048
"abcde12345"
"Tensorflow GPU Template"
"nvidia/cuda:11.0.3-devel-ubuntu18.04"
[
"bash",
"-c",
"apt update; apt install -y wget libpci3 xz-utils; wget ..."
]"ssh ssh_direc ssh_proxy"
[
["DOG", "CAT"],
["-p 70001:70001", "1"],
["-p 70002:70002", "1"]
]"echo 'hello'; echo $DOG; echo 'goodbye';"
"df77e27085bd4b3bd5d9024bdefb9e6df614b27adb0689e9d8f066fce5e01f0c"
"success, running nvidia/cuda_11.0.3-devel-ubuntu18.04/ssh"
"192.0.2.45"
"10.0.0.5 172.17.0.2"
"ssh123.vast.ai"
"6"
10600
21000
12
1668804745.1223178
1735689600
null
-25323348.860099316
"amd64"
4
4
"Core™ i5-6500"
15989
0
15.71815424
0.00996352
0.543945
"GTX 1070"
"nvidia"
16222
8111
0
38.999981
1
16
187.1
0
"Seagate ST4000DM000"
10.08
159.98852679060644
0.05400000140070915
0.05400000140070915
1001
20000
20002
false
"California, United States"
"verified"
true
7
0.296
false
0.8
0.8021
null
null
15.41170427627478
12.361728000000001
null
0.9686655
null
"Z170M Extreme4"
3
11.6
2
null
{
"gpuCostPerHour": 0.8,
"diskHour": 0.0021,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.8013181279189862
}{
"gpuCostPerHour": 0.8,
"diskHour": 0.001318127918986086,
"totalHour": 0.8021,
"discountTotalHour": 0,
"discountedTotalPerHour": 0.5034620970565428
}0.15
0.0021
0.00004944519787942301
4792.991450253207
0.3723200385780543
0.4
100000000
1
false
"12 Mon 24 D 16 Hr"
"11 Mon 26 D 6 Hr"
null
[]