> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Sessions

> Tenant-scoped endpoint for inspecting and controlling active realtime voice sessions.

Tenant-scoped endpoint for inspecting and controlling active realtime voice sessions.

### Response

`SessionsListResponse`

<ResponseField name="ok" type="boolean" required>
  Whether the request succeeded
</ResponseField>

<ResponseField name="sessions" type="SessionInfo[]" required>
  Active voice sessions

  <Expandable title="SessionInfo">
    <ResponseField name="agent_name" type="string,null">
      AI agent name (optional)
    </ResponseField>

    <ResponseField name="call_type" type="string,null">
      Type of call (inbound/outbound/sip\_inbound/etc)
    </ResponseField>

    <ResponseField name="customer_phone" type="string,null">
      Customer's phone number (optional)
    </ResponseField>

    <ResponseField name="escalated" type="boolean" required>
      Whether the session has been escalated to a human
    </ResponseField>

    <ResponseField name="escalation_target" type="string,null">
      Escalation target (optional)
    </ResponseField>

    <ResponseField name="greeting" type="string,null">
      Greeting message (optional)
    </ResponseField>

    <ResponseField name="org_id" type="string,null">
      Organization ID (optional)
    </ResponseField>

    <ResponseField name="started_at" type="string" required>
      Session start time (ISO 8601)
    </ResponseField>

    <ResponseField name="stream_sid" type="string" required>
      Unique stream SID from Twilio
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="tenant" type="string" required>
  Tenant identifier
</ResponseField>

### Status codes

| Code  | Meaning                                        |
| ----- | ---------------------------------------------- |
| `200` | List active sessions                           |
| `401` | Unauthorized - invalid or missing bearer token |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/api/v1/sessions' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "sessions": [
      {
        "agent_name": "Front Desk",
        "call_type": "inbound",
        "customer_phone": "+15555555678",
        "escalated": false,
        "escalation_target": null,
        "greeting": "Thanks for calling Acme Dental.",
        "org_id": "org-456",
        "started_at": "2026-05-14T17:40:02Z",
        "stream_sid": "MZ1234567890abcdef1234567890abcdef"
      }
    ],
    "tenant": "tenant_acme_dental"
  }
  ```
</ResponseExample>