---
title: "List active sessions"
method: GET
path: "/phones/sessions/active"
tags: ["phones"]
---

# List active sessions

`GET /phones/sessions/active`

Returns one page of the organization's currently-active phone sessions joined with phone + workflow display fields: in-flight runs, workflow-less interactive leases, and dedicated phones in use. Paginated via limit (default 25, max 100) + offset; the response total is the full active count.

## Query parameters

- `limit` integer — max rows to return (default 25, max 100)
- `offset` integer — rows to skip for pagination
- `search` string — case-insensitive match on phone name/nickname/id, session id, or workflow name
- `dedicated` string — filter by ownership: 'dedicated' or 'shared'
- `source` string — filter by source: 'workflow' or 'interactive'

## Response `200`

OK

- PhoneActiveSessionsResponse — Org's currently-active phone allocations.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `sessions` PhoneActiveSession[], nullable, required — List of active allocations, newest first.
    - `allocated_at` string, date-time, required — When the session claimed the phone.
    - `allocated_by` 'workflow_editor' | 'dashboard_run' | 'api_run' | 'interactive' — AllocatedBy identifies what triggered the allocation (WORKFLOW_EDITOR, DASHBOARD_RUN, API_RUN, INTERACTIVE).
    - `is_dedicated_phone` boolean, required — True when the phone is a dedicated/rented phone.
    - `location` string — Rack/data-center the phone is pinned to.
    - `model_name` string — Phone's model, if known.
    - `name` string — Optional user-chosen session label; unique among the org's active sessions.
    - `nickname` string — Org's nickname for the phone, if set.
    - `phone_id` string, required — Phone claimed by the session.
    - `phone_name` string — Phone's name, if set.
    - `phone_status` 'active' | 'inactive' | 'maintenance' | 'suspended', required — Phone's lifecycle status (ACTIVE/INACTIVE/...).
    - `phone_type` 'android' | 'iphone' | 'unknown' — IPHONE or ANDROID.
    - `session_id` string, uuid, required — Phone_sessions row id (the canonical session id).
    - `tags` object — Optional key->value labels attached to the session.
    - `workflow_id` string — Workflow tied to the session, nil for an interactive lease.
    - `workflow_name` string — Tied workflow's name, nil for an interactive lease.
  - `total` integer, required — Number of active allocations.

## Other responses

- `default` — Error

## Changes

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

- **2026-07-13** `84e4b1138a85` — 2 info
  - added the optional property `sessions/items/name` to the response with the `200` status
  - added the optional property `sessions/items/tags` to the response with the `200` status
- **2026-07-03** `5ae84ace57ac` — 11 warning
  - added the new `active` enum value to the `sessions/items/phone_status` response property for the response status `200`
  - added the new `android` enum value to the `sessions/items/phone_type` response property for the response status `200`
  - added the new `api_run` enum value to the `sessions/items/allocated_by` response property for the response status `200`
  - added the new `dashboard_run` enum value to the `sessions/items/allocated_by` response property for the response status `200`
  - …7 more
- **2026-07-01** `e2a192903d23` — 1 info
  - api operation id `devices_active_sessions` removed and replaced with `phones_active_sessions`
- **2026-07-01** `f8ffe9f2b8ee` — 2 info
  - api tag `phones` added
  - api tag `devices` removed
- **2026-06-29** `206b42a858c3` — 1 info
  - api operation id `device-sessions-active` removed and replaced with `devices_active_sessions`

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