---
title: "Get a phone"
method: GET
path: "/phones/{phone_id}"
tags: ["phones"]
---

# Get a phone

`GET /phones/{phone_id}`

Returns a single phone by its identifier.

## Path parameters

- `phone_id` string, required — device identifier

## Response `200`

OK

- PhoneSummary — A phone in the fleet: display identity, status, and current allocation.
  - `$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

> 18 revisions in range; 8 could not be searched.

- **2026-07-13** `84e4b1138a85` — 7 breaking
  - removed the required property `agent_version` from the response with the `200` status
  - removed the required property `android_version` from the response with the `200` status
  - removed the required property `imei1` from the response with the `200` status
  - removed the required property `imei2` from the response with the `200` status
  - …3 more
- **2026-07-03** `5ae84ace57ac` — 3 breaking, 9 warning, 2 info
  - removed the required property `create_date` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `update_date` from the response with the `200` status
  - added the new `active` enum value to the `status` response property for the response status `200`
  - …10 more
- **2026-07-01** `e2a192903d23` — 1 info
  - api operation id `devices_get` removed and replaced with `phones_get`
- **2026-07-01** `f8ffe9f2b8ee` — 2 info
  - api tag `phones` added
  - api tag `devices` removed
- **2026-06-29** `206b42a858c3` — 1 info
  - api operation id `device-get` removed and replaced with `devices_get`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/phones/:phone_id/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/8a66f81813b3/schema)