---
title: "List conversations"
method: GET
path: "/conversations"
---

# List conversations

`GET /conversations`

## Request

- Base URL: `https://osis.co/api/v1/comms`
- URL: `https://osis.co/api/v1/comms/conversations`
- Auth: HTTP bearer

List the conversations on your lines. Agent keys see every line attached to the agent unless you filter. Scope: `comms_read`.

## Query parameters

- `line_e164` string
- `state` 'agent' | 'needs_human' | 'human' | 'waiting' | 'resolved' | 'all'
- `q` string
- `limit` integer

## Response `200`

Conversation list

- object
  - `conversations` Conversation[]
    - `id` string
    - `contact_id` string
    - `phone` string: The other person's number, in E.164 format.
    - `name` string
    - `channel` string
    - `state` string
    - `last_message_at` string, date-time
    - `last_message_preview` string
    - `unread` boolean
    - `line_e164` string: Your number in this conversation. Left out if unknown.

## Other responses

- `401`: API key is missing or wrong
- `403`: Your key doesn't have the scope this needs

---

[API](https://skmtc.dev/osis/apis/comms-api.md) · [All operations](https://skmtc.dev/osis/apis/comms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/osis/apis/comms-api/revisions/59a4c0ba8936?raw)