---
title: "List phones ready to start a session"
method: GET
path: "/phones/available"
tags: ["phones"]
---

# List phones ready to start a session

`GET /phones/available`

Returns the Android phones the caller can start a session on right now: every active phone in the shared pool, plus the caller org's own dedicated phones that are currently free. Only free + active phones appear here, so a dedicated phone that is busy or offline is intentionally absent - use GET /phones/my to see the org's full dedicated inventory including in-use ones.

## Query parameters

- `phone_type` 'android' — only return Android phones

## Response `200`

OK

- PhoneAvailableListResponse — Returned when querying available devices for allocation.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `android_count` integer, required — Number of available Android devices.
  - `phones` PhoneSummary[], nullable, required — List of available device records.
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `created_at` string, date-time, required — When the phone record was created.
    - `current_session_id` string, nullable, required — Session currently holding the phone, if allocated.
    - `last_heartbeat` string, date-time, nullable, required — Time of the phone's most recent heartbeat.
    - `last_interaction_timestamp` string, date-time, nullable, required — Time of the most recent interaction on the phone.
    - `location` string, nullable, required — Physical hosting location of the phone.
    - `model_id` string, nullable, required — Hardware model identifier.
    - `model_name` string, nullable, required — Hardware model name.
    - `nickname` string, nullable, required — User-assigned nickname.
    - `owner_organization_id` string, nullable, required — Owning organization, for private phones.
    - `ownership_type` 'shared' | 'private', required — 'shared' for pool phones, 'private' for dedicated rentals.
    - `phone_id` string, required — Phone identifier used by allocate and the phone APIs.
    - `phone_name` string, nullable, required — Display name of the phone.
    - `phone_type` 'android' | 'iphone' | 'unknown', nullable, required — Platform of the phone.
    - `rental_expires_at` string, date-time, nullable, required — When the current rental ends, for rented phones.
    - `status` 'active' | 'inactive' | 'maintenance' | 'suspended', required — Fleet status of the phone.
    - `updated_at` string, date-time, required — When the phone record was last updated.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/108ab4b41051/schema)