---
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

---

[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)