---
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 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. Optionally filtered by phone_type; counts by type are included alongside the list.

## Query parameters

- `phone_type` 'iphone' | 'android' — only return phones of this type

## 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.
  - `iphone_count` integer, required — Number of available iPhones.
  - `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

## Changes

- **2026-07-18** `80c0e071bf67` — 1 warning, 1 info
  - deleted the `query` request parameter `device_type`
  - added the new optional `query` request parameter `phone_type`
- **2026-07-13** `84e4b1138a85` — 7 breaking
  - removed the required property `phones/items/agent_version` from the response with the `200` status
  - removed the required property `phones/items/android_version` from the response with the `200` status
  - removed the required property `phones/items/imei1` from the response with the `200` status
  - removed the required property `phones/items/imei2` from the response with the `200` status
  - …3 more
- **2026-07-03** `5ae84ace57ac` — 3 breaking, 9 warning, 2 info
  - removed the required property `phones/items/create_date` from the response with the `200` status
  - removed the required property `phones/items/id` from the response with the `200` status
  - removed the required property `phones/items/update_date` from the response with the `200` status
  - added the new `active` enum value to the `phones/items/status` response property for the response status `200`
  - …10 more
- **2026-07-01** `e2a192903d23` — 1 info
  - api operation id `devices_available` removed and replaced with `phones_available`
- **2026-07-01** `f8ffe9f2b8ee` — 2 info
  - api tag `phones` added
  - api tag `devices` removed

[Full history](https://skmtc.dev/axilioai/apis/axilio-api/changes/phones/available/get.md)

---

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