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

---

[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/versions/108ab4b41051/schema)