---
title: "Get instance by id"
method: GET
path: "/v1/instances/{instance_id}"
tags: ["Instances"]
---

# Get instance by id

`GET /v1/instances/{instance_id}`

## Path parameters

- `instance_id` string, required

## Response `200`

Instance details

- GetInstanceResponsePublicApiDto
  - `id` string, required
  - `ip` string, nullable, required — Public address; `null` when the instance is not reachable from the internet
  - `private_ip` string, nullable, required — Private (VPC) address; `null` when the instance is not on a private network
  - `status` 'running' | 'provisioning' | 'offline' | 'discontinued' | 'unknown' | 'ordered' | 'notfound' | 'new' | 'error' | 'deleting' | 'validating' | 'no_capacity' | 'installation_failed', required
  - `created_at` string, required
  - `created_by_user_id` string
  - `cpu` object, required
  - `gpu` object, required
  - `gpu_memory` object, required
  - `memory` object, required
  - `storage` object, required
  - `hostname` string, required
  - `description` string, required
  - `tags` TagResponseDto[], required
    - `id` string, required
    - `key` string, required
    - `value` string, required — Empty string for a freeform tag
  - `location` string, required
  - `price_per_hour` number, required
  - `is_spot` boolean, required
  - `instance_type` string, required
  - `image` string, required
  - `os_name` string, required
  - `startup_script_id` string, required
  - `ssh_key_ids` string[], required
  - `os_volume_id` string, required
  - `jupyter_token` string, required
  - `contract` 'LONG_TERM' | 'PAY_AS_YOU_GO' | 'SPOT', required
  - `pricing` 'DYNAMIC_PRICE' | 'FIXED_PRICE', required
  - `volume_ids` string[], required

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)