---
title: "List Conversations"
method: GET
path: "/channel/whatsapp/inbox/conversation"
tags: ["Conversations"]
---

# List Conversations

`GET /channel/whatsapp/inbox/conversation`

## Request

- Base URL: `https://{youraccountname}.api-us1.com/api/3`
- URL: `https://{youraccountname}.api-us1.com/api/3/channel/whatsapp/inbox/conversation`
- Auth: API key in header `Token`

Lists Conversations.

## Query parameters

- `contact` string, uuid
- `page` integer
- `page_size` integer
- `search` string

## Response `200`

- PaginatedConversationReadSimpleList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ConversationReadSimple[], required
    - `id` string, required: The UUID of the Conversation.
    - `contact` string, uuid, required
    - `status` 'CREATED' | 'FLOW' | 'NEW' | 'IN_PROGRESS' | 'RESOLVED' | 'CLOSED', required: * `CREATED` - Created * `FLOW` - Flow * `NEW` - New * `IN_PROGRESS` - In Progress * `RESOLVED` - Resolved * `CLOSED` - Closed
    - `first_message` WhatsAppMessageSimple, required
      - `id` string, required
      - `to_number` string, required
      - `from_number` string, required
      - `body` string, nullable
      - `direction` string, required
      - `timestamp` string, date-time, required
      - `contact` string, required
      - `status` 'new' | 'retry' | 'accepted' | 'sending' | 'sent' | 'receiving' | 'received' | 'delivered' | 'undelivered' | 'failed' | 'read' | 'deleted', required: * `new` - New * `retry` - Retry * `accepted` - Accepted * `sending` - Sending * `sent` - Sent * `receiving` - Receiving * `received` - Received * `delivered` - Delivered * `undelivered` - Undelivered * `failed` - Failed * `read` - Read * `deleted` - Deleted
      - `queued_on` string, date-time, nullable, required
      - `accepted_on` string, date-time, nullable, required
      - `sent_on` string, date-time, nullable, required
      - `delivered_on` string, date-time, nullable, required
      - `read_on` string, date-time, nullable, required
      - `failed_on` string, date-time, nullable, required
      - `provider_id` string, nullable, required
      - `provider_error_code` string, nullable, required
      - `provider_error_message` string, nullable, required
      - `sent_by` SimpleUser, required
        - `first_name` string
        - `last_name` string
        - `email` string, email, required
        - `id` integer, required
        - `profile_image` string, uri, nullable
        - `role` integer, nullable
      - `is_deleted` boolean, required
      - `content` unknown, required
      - `whatsapp_template` string, uuid, nullable, required
      - `content_type` string, nullable, required
      - `content_url` string, uri, nullable
      - `msg_type` 'audio' | 'voice' | 'button' | 'document' | 'text' | 'image' | 'interactive' | 'order' | 'sticker' | 'system' | 'unknown' | 'video' | 'unsupported' | 'location' | 'contacts' | 'template' | 'reaction' | 'ephemeral' | 'request_welcome': * `audio` - Audio * `voice` - Voice * `button` - Button * `document` - Document * `text` - Text * `image` - Image * `interactive` - Interactive * `order` - Order * `sticker` - Sticker * `system` - System * `unknown` - Unknown * `video` - Video * `unsupported` - Unsupported * `location` - Location * `contacts` - Contacts * `template` - Template * `reaction` - Reaction * `ephemeral` - Ephemeral * `request_welcome` - Request Welcome
      - `failed_attempts` integer, required
      - `source` 'INBOUND' | 'INBOX' | 'AUTO_RESPONSE' | 'API' | 'BROADCAST' | 'FLOW', required: * `INBOUND` - Inbound * `INBOX` - Inbox * `AUTO_RESPONSE` - Auto Response * `API` - Api * `BROADCAST` - Broadcast * `FLOW` - Flow
    - `assigned` UserSimple[], required: The Users assigned to the Conversation.
      - `id` integer, required
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `account` integer, nullable, required
      - `profile_image` string, uri, nullable, required
      - `date_joined` string, date-time, required
    - `tags` ConversationTag[]: The Tags assigned to the Conversation.
      - `id` integer, required
      - `name` string, required
    - `created_on` string, date-time, required
    - `source` 'INBOX' | 'AUTO_RESPONSE' | 'API' | 'BROADCAST' | 'FLOW' | 'UNKNOWN', required: * `INBOX` - Inbox * `AUTO_RESPONSE` - Auto Response * `API` - Api * `BROADCAST` - Broadcast * `FLOW` - Flow * `UNKNOWN` - Unknown
    - `assigned_team` integer: The ID of the Team assigned to the Conversation.
    - `channel` integer, nullable

---

[API](https://skmtc.dev/activecampaign/apis/whatsapp-api.md) - [All operations](https://skmtc.dev/activecampaign/apis/whatsapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/activecampaign/apis/whatsapp-api/revisions/6c7855d91b4d?raw)