Skip to main content
GET
/
compute
/
instances
List Compute Instances
curl --request GET \
  --url https://api.fal.ai/v1/compute/instances \
  --header 'Authorization: <api-key>'
{
  "instances": [
    {
      "id": "inst_abc123xyz",
      "instance_type": "gpu_1x_h100_sxm5",
      "region": "us-west",
      "sector": "sector_1",
      "ip": "203.0.113.42",
      "status": "ready",
      "creator_user_nickname": "developer"
    },
    {
      "id": "inst_def456uvw",
      "instance_type": "gpu_8x_h100_sxm5",
      "region": "us-east",
      "status": "provisioning",
      "creator_user_nickname": "developer"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Admin API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_ADMIN_API_KEY

Query Parameters

​
limit
integer

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

Required range: x >= 1
Example:

50

​
cursor
string

Pagination cursor from previous response. Encodes the page number.

Example:

"Mg=="

Response

Successfully retrieved compute instances

Response containing a list of compute instances with pagination support

​
next_cursor
string | null
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