---
title: "List your phones"
method: GET
path: "/phones/my"
tags: ["Phones"]
---

# List your phones

`GET /phones/my`

Returns private and rented phones owned by the caller's org. include_expired=true keeps rentals past their rental_expires_at in the result so users can see what they used to own.

## 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)
- `type` string[], nullable — filter by phone type (IPHONE/ANDROID)
- `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

- PhonePrivatePhonesResponse
  - `limit` integer, required
  - `offset` integer, required
  - `phones` PhonePhoneSummary[], nullable, required
    - `agent_version` string, nullable, required
    - `android_version` string, nullable, required
    - `create_date` string, date-time, required
    - `current_session_id` string, nullable, required
    - `id` string, required
    - `imei1` string, nullable, required
    - `imei2` string, nullable, required
    - `last_heartbeat` string, date-time, nullable, required
    - `last_interaction_timestamp` string, date-time, nullable, required
    - `location` string, nullable, required
    - `model_id` string, nullable, required
    - `model_name` string, nullable, required
    - `nickname` string, nullable, required
    - `one_ui_version` string, nullable, required
    - `owner_organization_id` string, nullable, required
    - `ownership_type` string, required
    - `phone_id` string, required
    - `phone_metadata` object, required
    - `phone_name` string, nullable, required
    - `phone_serial` string, nullable, required
    - `phone_type` string, nullable, required
    - `rental_expires_at` string, date-time, nullable, required
    - `status` string, required
    - `update_date` string, date-time, required
  - `total` integer, required

## Other responses

- `default` — Error

---

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