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

# List Conversations

> Synced LinkedIn conversations for a connected account, newest activity first.

Returns the account's synced conversations, newest activity first, with attendees and unread counts. Free, proof-signed, keyset-paginated. Only synced data comes back. See [Sync](/api-reference/linkedin/sync).

## Query

<ParamField query="cursor" type="string" optional>`next_cursor` from the previous page.</ParamField>
<ParamField query="limit" type="number" default="50">1–100.</ParamField>
<ParamField query="since" type="string" optional>ISO time. Returns only conversations **changed** after it (new message, read, metadata). Use it to poll for activity.</ParamField>
<ParamField query="unread" type="boolean" optional>`true` returns only conversations with unread messages.</ParamField>
<ParamField query="archived" type="boolean" default="false">Include archived conversations instead of active ones.</ParamField>

## Response

```json theme={null}
{
  "conversations": [
    {
      "id": "…",
      "provider_chat_id": "…",
      "name": "Sam Rivera",
      "subject": null,
      "type": 0,
      "attendees": [
        { "provider_id": "…", "name": "Jane Doe", "is_self": true, "profile_url": null, "headline": null, "occupation": null, "location": null, "network_distance": "SELF" },
        { "provider_id": "…", "name": "Sam Rivera", "is_self": false, "profile_url": "https://www.linkedin.com/in/…", "headline": "CTO at …", "occupation": null, "location": "Austin, TX", "network_distance": "DISTANCE_1" }
      ],
      "unread_count": 1,
      "archived": false,
      "read_only": 0,
      "muted_until": null,
      "last_message_at": "2026-09-15T11:58:00.000Z",
      "attendees_synced": true,
      "updated_at": "2026-09-15T12:00:03.000Z"
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0…",
  "has_more": true,
  "coverage": { "…": "…", "complete": false },
  "sync_state": "partial"
}
```

* `attendees_synced: false` means the conversation is a stub created from a message page. Attendee names arrive on a later run or the nightly refresh.
* `read_only` is LinkedIn's flag (`1` or `2` = cannot send). Replies to these conversations are rejected before payment.
* Attendee `contact_info` and picture URLs are not stored or returned.

<Note>
  An empty `conversations` array with `sync_state` ≠ `complete` means *not synced yet*, not an empty inbox. Check `coverage` before drawing conclusions.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.