---
title: "List details of a specific instance"
method: GET
path: "/instances/{id}"
---

# List details of a specific instance

`GET /instances/{id}`

Retrieves details of a specific instance, including whether or not the instance is running.

## Path parameters

- `id` string, required — Unique identifier (ID) of an instance

## Response `200`

OK

- object
  - `data` Instance, required — Virtual machine (VM) in Lambda Cloud
    - `id` string, required — Unique identifier (ID) of an instance
    - `name` string, nullable — User-provided name for the instance
    - `ip` string, nullable — IPv4 address of the instance
    - `status` 'active' | 'booting' | 'unhealthy' | 'terminated', required — The current status of the instance
    - `ssh_key_names` SshKeyName[], required — Names of the SSH keys allowed to access the instance
    - `file_system_names` FileSystemName[], required — Names of the file systems, if any, attached to the instance
    - `region` Region
      - `name` string, required — Short name of a region
      - `description` string, required — Long name of a region
    - `instance_type` InstanceType — Hardware configuration and pricing of an instance type
      - `name` string, required — Name of an instance type
      - `description` string, required — Long name of the instance type
      - `price_cents_per_hour` integer, required — Price of the instance type, in US cents per hour
      - `specs` object, required
        - `vcpus` integer, required — Number of virtual CPUs
        - `memory_gib` integer, required — Amount of RAM, in gibibytes (GiB)
        - `storage_gib` integer, required — Amount of storage, in gibibytes (GiB).
    - `hostname` string, nullable — Hostname assigned to this instance, which resolves to the instance's IP.
    - `jupyter_token` string, nullable — Secret token used to log into the jupyter lab server hosted on the instance.
    - `jupyter_url` string, nullable — URL that opens a jupyter lab notebook on the instance.

## Other responses

- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Object does not exist.

---

[API](https://skmtc.dev/unweave/apis/lambda-cloud-api.md) · [All operations](https://skmtc.dev/unweave/apis/lambda-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unweave/lambda-cloud-api/revisions/fd68e04e7a08/schema)