---
title: "List WhatsApp conversations"
method: GET
path: "/conversations"
tags: ["Conversations & Live Chat"]
---

# List WhatsApp conversations

`GET /conversations`

## Request

- Base URL: `https://api.envoisms.ma/v1`
- URL: `https://api.envoisms.ma/v1/conversations`
- Auth: HTTP bearer

Retrieves all active 2-way conversation threads with 24-hour service window expiry time and bot status.

## Query parameters

- `limit` integer
- `bot_status` 'active' | 'muted'

## Response `200`

List of conversation threads

- object
  - `conversations` ConversationThread[]
    - `phone` string
    - `contact_name` string
    - `last_message` string
    - `last_message_at` string, date-time
    - `unread_count` integer
    - `bot_muted` boolean
    - `can_reply_free` boolean
    - `window_expires_at` string, date-time
  - `total` integer

---

[API](https://skmtc.dev/envoisms/apis/envoisms-ma-api.md) · [All operations](https://skmtc.dev/envoisms/apis/envoisms-ma-api/llms.txt) · [OpenAPI document](https://skmtc.dev/envoisms/apis/envoisms-ma-api/revisions/662db074bd86?raw)