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

# List Conversations

`GET /conversations`

List conversations from email inbox or LinkedIn inbox with filtering and pagination.
Use `channel` to filter by platform. Use `last_message_direction` to filter by who sent the last message:
- `inbound` = replies from contacts (needs your response)
- `outbound` = your sent messages (waiting on their reply)

## Query parameters

- `team_id` string, uuid
- `channel` 'email' | 'linkedin'
- `last_message_direction` 'inbound' | 'outbound'
- `identity_id` string, uuid
- `status` 'archived' | 'unarchived'
- `read_status` 'read' | 'unread'
- `search` string
- `sort_by` 'date'
- `sort_direction` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

List of conversations

- ConversationListResponse
  - `success` boolean
  - `request_id` string
  - `data` Conversation[]
    - `object` 'conversation'
    - `id` string, uuid
    - `platform_type` 'email' | 'linkedin'
    - `title` string
    - `last_activity_at` string, date-time
    - `is_unread` boolean
    - `is_archived` boolean
    - `unread_count` integer
    - `identity` object, nullable
      - `id` string, uuid
      - `handle` string
      - `first_name` string
      - `last_name` string
      - `photo` string, uri
      - `type` 'linkedin'
    - `participants` ConversationParticipant[] — Participants in the conversation (populated in GET /conversations/{id}; empty in list)
      - `id` string, uuid, nullable — Platform person profile ID (null if profile unavailable)
      - `display_name` string, nullable — Display name for the participant
      - `avatar_url` string, uri, nullable — Avatar/profile image URL
      - `username` string, nullable — Email address (email) or platform handle (LinkedIn)
      - `is_self` boolean — Whether this participant is the authenticated user/team member
    - `last_message` object, nullable
      - `text` string
      - `timestamp` string, date-time
    - `team_id` string, uuid
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` Pagination
    - `limit` integer
    - `offset` integer
    - `total` integer
    - `has_more` boolean

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Access denied

---

[API](https://skmtc.dev/supersend/apis/supersend-api.md) · [All operations](https://skmtc.dev/supersend/apis/supersend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supersend/supersend-api/revisions/f0cbeaa12643/schema)