---
title: "List Compute Instances"
method: GET
path: "/compute/instances"
tags: ["Compute"]
---

# List Compute Instances

`GET /compute/instances`

Returns a list of all compute instances belonging to the authenticated user's workspace.

**Requirements:**
- Requires compute permissions (extra_permissions.compute = true)
- Authentication required via admin API key

**Key Features:**
- View all instances regardless of status
- Includes instance configuration, region, and current status
- Paginated results for large instance lists

**Common Use Cases:**
- Monitor all active compute resources
- Check instance status and availability
- Audit compute resource usage
- Build compute management dashboards

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

## Query parameters

- `limit` integer — Maximum number of items to return. Actual maximum depends on query type and expansion parameters.
- `cursor` string — Pagination cursor from previous response. Encodes the page number.

## Response `200`

Successfully retrieved compute instances

- object — Response containing a list of compute instances with pagination support
  - `next_cursor` string, nullable, required — Cursor for the next page of results, null if no more pages
  - `has_more` boolean, required — Boolean indicating if more results are available (convenience field derived from next_cursor)
  - `instances` object[], required — Array of compute instances belonging to the authenticated user
    - `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
- `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)