show instance

show instance

curl --request GET \
  --url https://console.vast.ai/api/v0/instances/{id}/ \
  --header 'Authorization: Bearer <token>'

{
  "instances": {
    "id": 883,
    "actual_status": "running",
    "intended_status": "running",
    "cur_state": "running",
    "next_state": "running",
    "label": null,
    "template_id": null,
    "template_hash_id": null,
    "template_name": null,
    "image_uuid": "tensorflow/tensorflow:latest-gpu",
    "image_args": [],
    "image_runtype": "ssh",
    "extra_env": [],
    "onstart": null,
    "jupyter_token": "53fc448d6644aa7535c6fa5498cdbedc782753e88d81b44090e54dcf1332ed30",
    "status_msg": null,
    "local_ipaddrs": "10.2.202.31 172.17.0.1 \n",
    "ssh_host": "ssh2281.vast.ai",
    "ssh_idx": "2281",
    "ssh_port": 10882,
    "machine_dir_ssh_port": 5300,
    "machine_id": 178,
    "bundle_id": 617,
    "start_date": 1761008618.225083,
    "end_date": 2034617753,
    "uptime_mins": null,
    "duration": 273608757.18784523,
    "cpu_arch": "amd64",
    "cpu_cores": 32,
    "cpu_cores_effective": 4,
    "cpu_name": "Xeon® Silver 4110",
    "cpu_ram": 128576,
    "cpu_util": 0,
    "mem_limit": null,
    "mem_usage": null,
    "vmem_usage": null,
    "gpu_name": "RTX A5000",
    "gpu_arch": "nvidia",
    "gpu_totalram": 24564,
    "gpu_ram": 24564,
    "gpu_util": null,
    "gpu_temp": null,
    "gpu_frac": 0.125,
    "gpu_lanes": 16,
    "gpu_mem_bw": 628.8,
    "bw_nvlink": 0,
    "disk_name": "Samsung SSD 860",
    "disk_space": 10,
    "disk_bw": 500.55,
    "disk_util": -1,
    "disk_usage": -1,
    "direct_port_count": 12,
    "direct_port_start": -1,
    "direct_port_end": -1,
    "ports": [
      8080,
      8081
    ],
    "static_ip": true,
    "public_ipaddr": "63.135.50.11",
    "geolocation": "Washington, US",
    "verification": "verified",
    "rentable": true,
    "host_id": 2,
    "hosting_type": 1,
    "min_bid": 0.02,
    "is_bid": false,
    "dph_base": 1,
    "dph_total": 1.0020740740740741,
    "dlperf": 22.229415,
    "dlperf_per_dphtotal": 22.183404974866942,
    "flops_per_dphtotal": 27.46814902424601,
    "total_flops": 27.52512,
    "score": 22.043656178546772,
    "reliability2": 0.9993661,
    "os_version": 18.04,
    "mobo_name": "S7109GM2NR",
    "pci_gen": 3,
    "pcie_bw": 11.7,
    "num_gpus": 1,
    "logo": "/static/logos/vastai_small2.png",
    "webpage": null,
    "search": {
      "gpuCostPerHour": 1,
      "diskHour": 0.002074074074074074,
      "totalHour": 1.0020740740740741,
      "discountTotalHour": 0,
      "discountedTotalPerHour": 1.0020740740740741
    },
    "instance": {
      "gpuCostPerHour": 0,
      "diskHour": 0.002074074074074074,
      "totalHour": 0.002074074074074074,
      "discountTotalHour": 0,
      "discountedTotalPerHour": 0.002074074074074074
    },
    "storage_cost": 0.14933333333333335,
    "storage_total_cost": 0.002074074074074074,
    "vram_costperhour": 0.00004079441760601181,
    "credit_balance": null,
    "credit_discount": null,
    "credit_discount_max": 0.4,
    "client_run_time": 1.1,
    "host_run_time": 2592000,
    "external": false,
    "time_remaining": "",
    "time_remaining_isbid": ""
  }
}

GET

api

instances

{id}

show instance

curl --request GET \
  --url https://console.vast.ai/api/v0/instances/{id}/ \
  --header 'Authorization: Bearer <token>'

{
  "instances": {
    "id": 883,
    "actual_status": "running",
    "intended_status": "running",
    "cur_state": "running",
    "next_state": "running",
    "label": null,
    "template_id": null,
    "template_hash_id": null,
    "template_name": null,
    "image_uuid": "tensorflow/tensorflow:latest-gpu",
    "image_args": [],
    "image_runtype": "ssh",
    "extra_env": [],
    "onstart": null,
    "jupyter_token": "53fc448d6644aa7535c6fa5498cdbedc782753e88d81b44090e54dcf1332ed30",
    "status_msg": null,
    "local_ipaddrs": "10.2.202.31 172.17.0.1 \n",
    "ssh_host": "ssh2281.vast.ai",
    "ssh_idx": "2281",
    "ssh_port": 10882,
    "machine_dir_ssh_port": 5300,
    "machine_id": 178,
    "bundle_id": 617,
    "start_date": 1761008618.225083,
    "end_date": 2034617753,
    "uptime_mins": null,
    "duration": 273608757.18784523,
    "cpu_arch": "amd64",
    "cpu_cores": 32,
    "cpu_cores_effective": 4,
    "cpu_name": "Xeon® Silver 4110",
    "cpu_ram": 128576,
    "cpu_util": 0,
    "mem_limit": null,
    "mem_usage": null,
    "vmem_usage": null,
    "gpu_name": "RTX A5000",
    "gpu_arch": "nvidia",
    "gpu_totalram": 24564,
    "gpu_ram": 24564,
    "gpu_util": null,
    "gpu_temp": null,
    "gpu_frac": 0.125,
    "gpu_lanes": 16,
    "gpu_mem_bw": 628.8,
    "bw_nvlink": 0,
    "disk_name": "Samsung SSD 860",
    "disk_space": 10,
    "disk_bw": 500.55,
    "disk_util": -1,
    "disk_usage": -1,
    "direct_port_count": 12,
    "direct_port_start": -1,
    "direct_port_end": -1,
    "ports": [
      8080,
      8081
    ],
    "static_ip": true,
    "public_ipaddr": "63.135.50.11",
    "geolocation": "Washington, US",
    "verification": "verified",
    "rentable": true,
    "host_id": 2,
    "hosting_type": 1,
    "min_bid": 0.02,
    "is_bid": false,
    "dph_base": 1,
    "dph_total": 1.0020740740740741,
    "dlperf": 22.229415,
    "dlperf_per_dphtotal": 22.183404974866942,
    "flops_per_dphtotal": 27.46814902424601,
    "total_flops": 27.52512,
    "score": 22.043656178546772,
    "reliability2": 0.9993661,
    "os_version": 18.04,
    "mobo_name": "S7109GM2NR",
    "pci_gen": 3,
    "pcie_bw": 11.7,
    "num_gpus": 1,
    "logo": "/static/logos/vastai_small2.png",
    "webpage": null,
    "search": {
      "gpuCostPerHour": 1,
      "diskHour": 0.002074074074074074,
      "totalHour": 1.0020740740740741,
      "discountTotalHour": 0,
      "discountedTotalPerHour": 1.0020740740740741
    },
    "instance": {
      "gpuCostPerHour": 0,
      "diskHour": 0.002074074074074074,
      "totalHour": 0.002074074074074074,
      "discountTotalHour": 0,
      "discountedTotalPerHour": 0.002074074074074074
    },
    "storage_cost": 0.14933333333333335,
    "storage_total_cost": 0.002074074074074074,
    "vram_costperhour": 0.00004079441760601181,
    "credit_balance": null,
    "credit_discount": null,
    "credit_discount_max": 0.4,
    "client_run_time": 1.1,
    "host_run_time": 2592000,
    "external": false,
    "time_remaining": "",
    "time_remaining_isbid": ""
  }
}

Authorizations

Authorization

string

header

required

API key must be provided in the Authorization header

Path Parameters

integer

required

The instance (contract) ID to retrieve.

Response

Success response with instance details.

instances

object

Detailed information about an instance.

Show child attributes

instances.id

integer

Unique identifier for the instance.

Example:

883

instances.actual_status

string | null

Current status of the instance container.

Example:

"running"

instances.intended_status

string

Intended status of the instance container.

Example:

"running"

instances.cur_state

string

Current state of the machine contract.

Example:

"running"

instances.next_state

string

Next scheduled state for the machine contract.

Example:

"running"

instances.label

string | null

User-defined label for the instance.

Example:

null

instances.template_id

integer | null

Identifier for the instance template.

Example:

null

instances.template_hash_id

string | null

Hash identifier for the instance template.

Example:

null

instances.template_name

string | null

Name of the template (if available).

Example:

null

instances.image_uuid

string

Docker image used for the instance.

Example:

"tensorflow/tensorflow:latest-gpu"

instances.image_args

string[]

Arguments passed to the container.

Example:

[]

instances.image_runtype

string

How the container is launched (ssh, jupyter, etc.).

Example:

"ssh"

instances.extra_env

string[]

Additional environment variables.

Example:

[]

instances.onstart

string | null

Script or command run at container start.

Example:

null

instances.jupyter_token

string

Jupyter token for the instance.

Example:

"53fc448d6644aa7535c6fa5498cdbedc782753e88d81b44090e54dcf1332ed30"

instances.status_msg

string | null

Status message for the instance.

Example:

null

instances.local_ipaddrs

string

Local IP addresses for the instance (space-separated).

Example:

"10.2.202.31 172.17.0.1 \n"

instances.ssh_host

string

Host (or IP) used for SSH connection.

Example:

"ssh2281.vast.ai"

instances.ssh_idx

string

Identifier for the SSH forwarder used.

Example:

"2281"

instances.ssh_port

integer

Port used for SSH connection.

Example:

10882

instances.machine_dir_ssh_port

integer

Calculated SSH port for accessing the machine directory.

Example:

5300

instances.machine_id

integer

ID of the physical machine.

Example:

178

instances.bundle_id

integer

ID of the bundle this instance belongs to.

Example:

617

instances.start_date

number<float>

Instance start time (epoch seconds).

Example:

1761008618.225083

instances.end_date

number<float>

Instance end time (epoch seconds).

Example:

2034617753

instances.uptime_mins

number | null

Uptime of the instance in minutes.

Example:

null

instances.duration

number<float>

Duration of the instance in seconds.

Example:

273608757.18784523

instances.cpu_arch

string

CPU architecture.

Example:

"amd64"

instances.cpu_cores

integer

Number of CPU cores.

Example:

32

instances.cpu_cores_effective

number<float>

Effective number of CPU cores allocated.

Example:

4

instances.cpu_name

string

Name of the CPU.

Example:

"Xeon® Silver 4110"

instances.cpu_ram

integer

Total system RAM in MB.

Example:

128576

instances.cpu_util

number<float>

CPU utilization as a fraction.

Example:

0

instances.mem_limit

number | null

Memory limit in megabytes.

Example:

null

instances.mem_usage

number | null

Memory usage in megabytes.

Example:

null

instances.vmem_usage

number | null

Virtual memory usage in megabytes.

Example:

null

instances.gpu_name

string

Name of the GPU.

Example:

"RTX A5000"

instances.gpu_arch

string

GPU architecture.

Example:

"nvidia"

instances.gpu_totalram

integer

Total GPU RAM in MB.

Example:

24564

instances.gpu_ram

integer

Allocated GPU RAM in MB.

Example:

24564

instances.gpu_util

number | null

GPU utilization as a fraction.

Example:

null

instances.gpu_temp

number | null

Current GPU temperature in Celsius.

Example:

null

instances.gpu_frac

number<float>

Fraction of GPU allocated.

Example:

0.125

instances.gpu_lanes

integer

Number of PCIe lanes for the GPU.

Example:

16

instances.gpu_mem_bw

number<float>

GPU memory bandwidth in GB/s.

Example:

628.8

instances.bw_nvlink

number<float>

NVLink bandwidth in GB/s.

Example:

0

instances.disk_name

string

Name of the disk.

Example:

"Samsung SSD 860"

instances.disk_space

number<float>

Disk space allocated in GB.

Example:

10

instances.disk_bw

number<float>

Disk bandwidth in MB/s.

Example:

500.55

instances.disk_util

number<float>

Disk utilization percentage.

Example:

-1

instances.disk_usage

number<float>

Disk usage percentage.

Example:

-1

instances.direct_port_count

integer

Number of direct ports available.

Example:

12

instances.direct_port_start

integer

Start of direct port range.

Example:

-1

instances.direct_port_end

integer

End of direct port range.

Example:

-1

instances.ports

integer[]

List of additional ports exposed by the instance.

Example:

[8080, 8081]

instances.static_ip

boolean

Whether the instance has a static public IP.

Example:

true

instances.public_ipaddr

string

Public IP address of the instance.

Example:

"63.135.50.11"

instances.geolocation

string

Geographical location of the instance.

Example:

"Washington, US"

instances.verification

string

Verification status of the instance.

Example:

"verified"

instances.rentable

boolean

Whether the instance is currently rentable.

Example:

true

instances.host_id

integer

Host ID for the instance.

Example:

2

instances.hosting_type

integer

Hosting type code.

Example:

1

instances.min_bid

number<float>

Minimum bid price for the instance.

Example:

0.02

instances.is_bid

boolean

Whether the instance was created via bidding.

Example:

false

instances.dph_base

number<float>

Base dollars per hour.

Example:

1

instances.dph_total

number<float>

Total dollars per hour.

Example:

1.0020740740740741

instances.dlperf

number<float>

Deep learning performance score.

Example:

22.229415

instances.dlperf_per_dphtotal

number<float>

DLPerf per total DPH.

Example:

22.183404974866942

instances.flops_per_dphtotal

number<float>

FLOPS per total DPH.

Example:

27.46814902424601

instances.total_flops

number<float>

Total FLOPS.

Example:

27.52512

instances.score

number<float>

Instance score.

Example:

22.043656178546772

instances.reliability2

number<float>

Reliability score.

Example:

0.9993661

instances.os_version

string

Operating system version.

Example:

18.04

instances.mobo_name

string

Motherboard name.

Example:

"S7109GM2NR"

instances.pci_gen

number<float>

PCIe generation.

Example:

3

instances.pcie_bw

number<float>

PCIe bandwidth in GB/s.

Example:

11.7

instances.num_gpus

integer

Number of GPUs allocated.

Example:

1

instances.logo

string

URL to the logo image.

Example:

"/static/logos/vastai_small2.png"

instances.webpage

string | null

URL to the instance's webpage, if available.

Example:

null

instances.search

object

Search pricing details.

Example:

{
  "gpuCostPerHour": 1,
  "diskHour": 0.002074074074074074,
  "totalHour": 1.0020740740740741,
  "discountTotalHour": 0,
  "discountedTotalPerHour": 1.0020740740740741
}

instances.instance

object

Instance pricing details.

Example:

{
  "gpuCostPerHour": 0,
  "diskHour": 0.002074074074074074,
  "totalHour": 0.002074074074074074,
  "discountTotalHour": 0,
  "discountedTotalPerHour": 0.002074074074074074
}

instances.storage_cost

number<float>

Storage cost per hour.

Example:

0.14933333333333335

instances.storage_total_cost

number<float>

Total storage cost.

Example:

0.002074074074074074

instances.vram_costperhour

number<float>

VRAM cost per hour.

Example:

0.00004079441760601181

instances.credit_balance

number | null

User's credit balance.

Example:

null

instances.credit_discount

number | null

User's credit discount.

Example:

null

instances.credit_discount_max

number

Maximum credit discount.

Example:

0.4

instances.client_run_time

number<float>

Client run time in hours.

Example:

1.1

instances.host_run_time

number<float>

Host run time in hours.

Example:

2592000

instances.external

boolean

Whether the instance is external.

Example:

false

instances.time_remaining

string

Time remaining for the instance (if applicable).

Example:

""

instances.time_remaining_isbid

string

Time remaining for the instance if it is a bid.

Example:

""

create instance manage instance

⌘I

API Reference

Endpoints

Authorizations

Path Parameters

Response