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

# List conversations

> GET /api/v1/comms/conversations — list threads on your line.

List conversation threads associated with your line.

**Scope:** `comms_read`

## Request

```bash theme={null}
curl "https://osis.co/api/v1/comms/conversations?limit=25" \
  -H "Authorization: Bearer $COMMS_API_KEY"
```

### Query parameters

<ParamField query="state" type="string">
  Filter by conversation state when set.
</ParamField>

<ParamField query="q" type="string">
  Search / query string.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of conversations to return.
</ParamField>

## Response

```json theme={null}
{
  "conversations": [
    {
      "id": "conv_…",
      "state": "open"
    }
  ]
}
```

To load messages for one thread, call [List messages](/messages-api/list-messages) with `conversation_id`.