---
title: "List conversations"
method: GET
path: "/v1/conversations"
tags: ["LinkedIn"]
---

# List conversations

`GET /v1/conversations`

## Request

- Base URL: `https://api.talktohumans.app`
- URL: `https://api.talktohumans.app/v1/conversations`
- Auth: HTTP bearer

Lists LinkedIn conversations.

## Query parameters

- `tag` string
- `contact_id` string
- `limit` integer
- `cursor` string

## Response `200`

Conversations matching the filters.

- ListConversationsEnvelope
  - `data` ListConversationsResponse, required
    - `conversations` Conversation[], required
      - `conversation_id` string, required: TalkToHumans conversation ID.
      - `account` AccountSummary, required
        - `account_id` string, required: TalkToHumans account ID.
        - `display_name` string, required
        - `provider_account_id` string, required: LinkedIn provider account ID.
        - `owner_user_id` string, required: TalkToHumans user ID that owns the account.
      - `title` string, required
      - `is_group` boolean, required
      - `participants` ConversationParticipant[], required
        - `account_relationship_id` string
        - `contact_id` string, required
        - `provider_participant_id` string, required
        - `public_identifier` string
        - `name` string, required
        - `first_name` string
        - `last_name` string
        - `headline` string
        - `primary_role_title` string
        - `primary_company_name` string
        - `linkedin_url` string, uri
        - `avatar_url` string, uri
        - `relationship_status` 'connected' | 'not_connected' | 'unknown', required
      - `last_message_text` string
      - `last_message_direction` 'sent' | 'received' | ''
      - `last_message_at` string, date-time, nullable
      - `current_state` string
      - `sequence` Sequence, nullable
        - `sequence_id` string, required
        - `status` string, required
        - `stop_if_person_replies` boolean, required
        - `reply_guard_after` string, date-time, nullable
        - `next_step_id` string
        - `next_step_scheduled_for` string, date-time, nullable
        - `steps` SequenceStep[], required
          - `step_id` string, required
          - `template_run_public_id` string
          - `step_type` string, required
          - `trigger_type` string, required
          - `position` integer, required
          - `scheduled_for` string, date-time, nullable
          - `message_mode` string, required
          - `state` string, required
      - `app_url` string, uri, required
    - `pagination` Pagination, required
      - `limit` integer, required
      - `has_more` boolean, required
      - `next_cursor` string: Cursor for the next page. Omitted when there are no more results.

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing, malformed, invalid, or retired local API key.
- `403`: API access is not enabled for the organization, the API key cannot resolve to an active organization user, or the credential cannot access the requested LinkedIn account.
- `429`: Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/talktohumans/apis/talktohumans-public-api.md) · [All operations](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/revisions/4551ad2f26af?raw)