---
title: "List Xcode instances"
method: GET
path: "/v1/xcode_instances"
---

# List Xcode instances

`GET /v1/xcode_instances`

## Query parameters

- `state` string
- `labelSelector` string
- `limit` integer
- `startingAfter` string
- `endingBefore` string

## Response `200`

OK

- XcodeInstance[]
  - `metadata` object, required
    - `id` string, required
    - `displayName` string
    - `organizationId` string, required
    - `createdAt` string, date-time, required
    - `terminatedAt` string, date-time
    - `labels` object
  - `spec` object, required
    - `region` string, required
    - `inactivityTimeout` string, duration, required
    - `hardTimeout` string, duration
  - `status` object, required
    - `state` 'unknown' | 'creating' | 'assigned' | 'ready' | 'terminated', required
    - `apiUrl` string
    - `token` string, required
    - `errorMessage` string
    - `terminationReason` string — Machine-readable reason the instance was terminated. Always present once state is "terminated", never present before that. New values may be added over time, so treat any unrecognized value as "Unknown". Known values: - "UserRequested": terminated by a delete request to the API. - "InactivityTimeout": the timeout given in spec.inactivityTimeout elapsed. - "HardTimeout": the timeout given in spec.hardTimeout elapsed. - "Unknown": terminated for a cause the platform did not attribute, including instances that failed to get ready during creation. See errorMessage for details when available.

## Other responses

- `default` — Error

## Changes

> 34 revisions in range; 1 could not be searched.

- **2026-07-14** `ba3dd85f4260` — 1 info
  - the `inactivityTimeout` response's property default value changed from `3m` to `5m` for the status `200`
- **2026-07-07** `22f89da81c8f` — 1 info
  - added the optional property `items/status/terminationReason` to the response with the `200` status
- **2026-04-09** `bf3778fef35f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/limrun-inc/apis/limrun-api/changes/v1/xcode_instances/get.md)

---

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