---
title: "List the org's dedicated phones"
method: GET
path: "/phones/my"
tags: ["phones"]
---

# List the org's dedicated phones

`GET /phones/my`

Returns the caller org's full dedicated (private/rented) phone inventory - every state, not just the free ones: busy phones in an active session, offline/inactive phones, and phones in maintenance are all included, so this is the endpoint to discover a phone_id you can pin via POST /phones/allocate. Each phone's current_session_id and status reflect its live state. include_expired=true also keeps rentals past their rental_expires_at so users can see what they used to own. Filter by status/phone_type and paginate; the response total is the full match count.

## Query parameters

- `include_expired` boolean — include rented devices whose rental window has expired
- `limit` integer
- `offset` integer
- `search` string — free-text search across nickname, name, model, location
- `status` string[], nullable — filter by phone status (active/inactive/maintenance/suspended); case-insensitive
- `type` string[], nullable — filter by phone type (iphone/android); case-insensitive
- `rental_expires_after` string — only phones whose rental expires at/after this RFC3339 time
- `rental_expires_before` string — only phones whose rental expires at/before this RFC3339 time
- `last_active_after` string — only phones last seen at/after this RFC3339 time
- `last_active_before` string — only phones last seen at/before this RFC3339 time
- `sort` string — sort column (created|rental_expires|last_active|status|type|location)
- `order` string — sort direction (asc|desc)

## Response `200`

OK

- PhonePrivateListResponse — Privately owned devices for an organization.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `limit` integer, required — Page size used for this response.
  - `offset` integer, required — Pagination offset used for this response.
  - `phones` PhoneSummary[], nullable, required — Page of private 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.
  - `total` integer, required — Total number of private devices matching the query.

## Other responses

- `default` — Error

## Changes

- **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_mine` removed and replaced with `phones_mine`
- **2026-07-01** `f8ffe9f2b8ee` — 2 info
  - api tag `phones` added
  - api tag `devices` removed
- **2026-06-29** `206b42a858c3` — 1 info
  - api operation id `device-my` removed and replaced with `devices_mine`

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