--- title: "show instance" method: GET path: "/api/v0/instances/{id}/" tags: ["Instances"] --- # show instance `GET /api/v0/instances/{id}/` Retrieves the details of a specific instance for the authenticated user. CLI Usage: `vastai show instance [--api-key ] [--raw]` ## Path parameters - `id` integer, required ## Response `200` Success response with instance details. - object - `instances` Instance — Detailed information about an instance. - `id` integer — Unique identifier for the instance. - `actual_status` string, nullable — Current status of the instance container. - `intended_status` string — Intended status of the instance container. - `cur_state` string — Current state of the machine contract. - `next_state` string — Next scheduled state for the machine contract. - `label` string, nullable — User-defined label for the instance. - `template_id` integer, nullable — Identifier for the instance template. - `template_hash_id` string, nullable — Hash identifier for the instance template. - `template_name` string, nullable — Name of the template (if available). - `image_uuid` string — Docker image used for the instance. - `image_args` string[] — Arguments passed to the container. - `image_runtype` string — How the container is launched (ssh, jupyter, etc.). - `extra_env` string[] — Additional environment variables. - `onstart` string, nullable — Script or command run at container start. - `jupyter_token` string — Jupyter token for the instance. - `status_msg` string, nullable — Status message for the instance. - `local_ipaddrs` string — Local IP addresses for the instance (space-separated). - `ssh_host` string — Host (or IP) used for SSH connection. - `ssh_idx` string — Identifier for the SSH forwarder used. - `ssh_port` integer — Port used for SSH connection. - `machine_dir_ssh_port` integer — Calculated SSH port for accessing the machine directory. - `machine_id` integer — ID of the physical machine. - `bundle_id` integer — ID of the bundle this instance belongs to. - `start_date` number, float — Instance start time (epoch seconds). - `end_date` number, float — Instance end time (epoch seconds). - `uptime_mins` number, nullable — Uptime of the instance in minutes. - `duration` number, float — Duration of the instance in seconds. - `cpu_arch` string — CPU architecture. - `cpu_cores` integer — Number of CPU cores. - `cpu_cores_effective` number, float — Effective number of CPU cores allocated. - `cpu_name` string — Name of the CPU. - `cpu_ram` integer — Total system RAM in MB. - `cpu_util` number, float — CPU utilization as a fraction. - `mem_limit` number, nullable — Memory limit in megabytes. - `mem_usage` number, nullable — Memory usage in megabytes. - `vmem_usage` number, nullable — Virtual memory usage in megabytes. - `gpu_name` string — Name of the GPU. - `gpu_arch` string — GPU architecture. - `gpu_totalram` integer — Total GPU RAM in MB. - `gpu_ram` integer — Allocated GPU RAM in MB. - `gpu_util` number, nullable — GPU utilization as a fraction. - `gpu_temp` number, nullable — Current GPU temperature in Celsius. - `gpu_frac` number, float — Fraction of GPU allocated. - `gpu_lanes` integer — Number of PCIe lanes for the GPU. - `gpu_mem_bw` number, float — GPU memory bandwidth in GB/s. - `bw_nvlink` number, float — NVLink bandwidth in GB/s. - `disk_name` string — Name of the disk. - `disk_space` number, float — Disk space allocated in GB. - `disk_bw` number, float — Disk bandwidth in MB/s. - `disk_util` number, float — Disk utilization percentage. - `disk_usage` number, float — Disk usage percentage. - `direct_port_count` integer — Number of direct ports available. - `direct_port_start` integer — Start of direct port range. - `direct_port_end` integer — End of direct port range. - `ports` integer[] — List of additional ports exposed by the instance. - `static_ip` boolean — Whether the instance has a static public IP. - `public_ipaddr` string — Public IP address of the instance. - `geolocation` string — Geographical location of the instance. - `verification` string — Verification status of the instance. - `rentable` boolean — Whether the instance is currently rentable. - `host_id` integer — Host ID for the instance. - `hosting_type` integer — Hosting type code. - `min_bid` number, float — Minimum bid price for the instance. - `is_bid` boolean — Whether the instance was created via bidding. - `dph_base` number, float — Base dollars per hour. - `dph_total` number, float — Total dollars per hour. - `dlperf` number, float — Deep learning performance score. - `dlperf_per_dphtotal` number, float — DLPerf per total DPH. - `flops_per_dphtotal` number, float — FLOPS per total DPH. - `total_flops` number, float — Total FLOPS. - `score` number, float — Instance score. - `reliability2` number, float — Reliability score. - `os_version` string — Operating system version. - `mobo_name` string — Motherboard name. - `pci_gen` number, float — PCIe generation. - `pcie_bw` number, float — PCIe bandwidth in GB/s. - `num_gpus` integer — Number of GPUs allocated. - `logo` string — URL to the logo image. - `webpage` string, nullable — URL to the instance's webpage, if available. - `search` object — Search pricing details. - `instance` object — Instance pricing details. - `storage_cost` number, float — Storage cost per hour. - `storage_total_cost` number, float — Total storage cost. - `vram_costperhour` number, float — VRAM cost per hour. - `credit_balance` number, nullable — User's credit balance. - `credit_discount` number, nullable — User's credit discount. - `credit_discount_max` number — Maximum credit discount. - `client_run_time` number, float — Client run time in hours. - `host_run_time` number, float — Host run time in hours. - `external` boolean — Whether the instance is external. - `time_remaining` string — Time remaining for the instance (if applicable). - `time_remaining_isbid` string — Time remaining for the instance if it is a bid. ## Other responses - `400` — Bad Request – Invalid instance ID or invalid arguments. - `401` — Unauthorized – Invalid or missing authentication. - `429` — Too Many Requests – API requests are too frequent. --- [API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)