---
title: "Get Android instance with given ID"
method: GET
path: "/v1/android_instances/{id}"
---

# Get Android instance with given ID

`GET /v1/android_instances/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- AndroidInstance
  - `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 — The region where the instance will be created. If not given, will be decided based on scheduling clues and availability.
    - `inactivityTimeout` string, duration, required — After how many minutes of inactivity should the instance be terminated. Example values 1m, 10m, 3h. Default is 3m. Providing "0" uses the organization's default inactivity timeout.
    - `hardTimeout` string, duration — After how many minutes should the instance be terminated. Example values 1m, 10m, 3h. Default is "0" which means no hard timeout.
  - `status` object, required
    - `state` 'unknown' | 'creating' | 'assigned' | 'ready' | 'terminated', required
    - `apiUrl` string
    - `adbWebSocketUrl` string
    - `endpointWebSocketUrl` string
    - `signedStreamUrl` string
    - `mcpUrl` string
    - `targetHttpPortUrlPrefix` string
    - `token` string, required
    - `sandbox` AndroidSandboxStatus
      - `playwrightAndroid` object
        - `url` string
    - `errorMessage` string

## Other responses

- `default` — Error

## Changes

- **2026-04-22** `68cf01d361fc` — 1 info
  - added the optional property `status/signedStreamUrl` to the response with the `200` status
- **2026-04-10** `863e69fb7be0` — 1 info
  - added the optional property `status/apiUrl` to the response with the `200` status
- **2026-03-20** `98f98bdf1eaa` — 1 info
  - added the optional property `status/mcpUrl` to the response with the `200` status
- **2025-12-15** `81ebcc39139f` — 1 info
  - added the optional property `status/errorMessage` to the response with the `200` status
- **2025-12-06** `7c65608f67ba` — 1 info
  - added the optional property `status/targetHttpPortUrlPrefix` to the response with the `200` status

[Full history](https://skmtc.dev/limrun-inc/apis/limrun-api/changes/v1/android_instances/:id/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/22b815649ef7/schema)