---
title: "Get Compute Instance"
method: GET
path: "/compute/instances/{id}"
tags: ["Compute"]
---

# Get Compute Instance

`GET /compute/instances/{id}`

Retrieves detailed information about a specific compute instance by its ID.

**Requirements:**
- Requires compute permissions (extra_permissions.compute = true)
- Authentication required via admin API key
- Instance must belong to the authenticated user's workspace

**Key Features:**
- Get current instance status and configuration
- Access instance IP address when available
- View region and sector placement
- Check creator information

**Common Use Cases:**
- Monitor specific instance status
- Retrieve connection details (IP address)
- Check instance readiness before use
- Audit instance configuration

See [fal.ai docs](https://fal.ai/docs/documentation/compute) for more details.

## Path parameters

- `id` string, required — Unique identifier for the compute instance

## Response `200`

Successfully retrieved compute instance details

- object — Compute instance details including configuration, location, and status
  - `id` string, required — Unique identifier for the compute instance
  - `instance_type` 'gpu_8x_h100_sxm5' | 'gpu_1x_h100_sxm5', required — Type of compute instance (GPU configuration)
  - `region` 'us-west' | 'us-central' | 'us-east' | 'eu-north' | 'eu-west' | 'other', required — Geographical region where the instance is located
  - `sector` 'sector_1' | 'sector_2' | 'sector_3' — Sector identifier for instance placement within the region (if applicable)
  - `ip` string — IP address of the instance (available when instance is ready)
  - `status` 'ready' | 'init' | 'pending' | 'provisioning' | 'stopped' | 'unknown', required — Current operational status of the instance
  - `creator_user_nickname` string — Nickname of the user who created this instance

## Other responses

- `401` — Authentication required
- `403` — Access denied
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)