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

# List sessions

`GET /phones/sessions`

Returns one page of the org's phone sessions for the Session Inspector table: active/unbilled sessions pinned on top, terminal history paginated beneath. Covers workflow runs and workflow-less interactive leases; each row links to a session. Filters: search, workflow_id, status.

## Query parameters

- `limit` integer — max rows to return (default 50, max 100)
- `offset` integer — rows to skip for pagination
- `search` string — case-insensitive match on phone/session/workflow
- `workflow_id` string — only sessions for this workflow
- `status` string[], nullable — filter by session status (ACTIVE/COMPLETED/CANCELLED/EXPIRED); repeatable
- `source` string[], nullable — filter by source: workflow and/or interactive; repeatable
- `dedicated` string[], nullable — filter by type: shared and/or dedicated; repeatable
- `started_after` string — only sessions started at/after this RFC3339 time
- `started_before` string — only sessions started at/before this RFC3339 time
- `ended_after` string — only sessions de-allocated at/after this RFC3339 time
- `ended_before` string — only sessions de-allocated at/before this RFC3339 time
- `sort` string — sort column: started|ended|status|duration (default started)
- `order` string — sort direction: asc|desc (default desc)

## Response `200`

OK

- PhoneSessionsListResponse
  - `limit` integer, required
  - `offset` integer, required
  - `sessions` PhoneSessionListItem[], nullable, required
    - `allocated_at` string, required
    - `allocated_by` string
    - `deallocated_at` string
    - `duration_seconds` integer
    - `is_dedicated_phone` boolean, required
    - `location` string
    - `model_name` string
    - `nickname` string
    - `phone_id` string, required
    - `phone_name` string
    - `phone_type` string
    - `session_id` string, required
    - `source` string, required
    - `status` string, required
    - `workflow_id` string
    - `workflow_name` string
  - `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)