---
title: "List WhatsApp conversations"
method: POST
path: "/whatsapp/conversations"
tags: ["whatsapp"]
---

# List WhatsApp conversations

`POST /whatsapp/conversations`

Retrieves WhatsApp conversations, optionally filtered by account UUID, with pagination support.

**Permission:** Access is managed by the WhatsApp service. No specific API token permission is checked.

**Monitoring:** No impact.

## Request body

- object
  - `limit_count` integer
  - `limit_offset` integer
  - `account_uuid` string

## Response `200`

Successful operation — returns the list of conversations.

- WhatsappConversationList
  - `limit_offset_setted` integer
  - `limit_count_setted` integer
  - `total_conversation_count` integer
  - `conversation_list_count` integer
  - `conversation_list` WhatsappConversation[]
    - `account_name` string
    - `account_namespace` string
    - `account_number` integer
    - `account_uuid` string, uuid
    - `application_id` string, uuid
    - `creation_date` string, date-time
    - `external_number` object
      - `alphanumeric` string
      - `number` integer
    - `internal_number` object
      - `alphanumeric` string
      - `number` integer
    - `is_archived` boolean
    - `is_favorite` boolean
    - `last_message` object
      - `OCost` integer
      - `Orate` integer
      - `creation_date` string, date-time
      - `data` string
      - `direction` string
      - `failed_cause` string, nullable
      - `is_failed` boolean
      - `schedule_date` string, date-time, nullable
      - `status` string
      - `update_date` string, date-time
      - `user_id` integer
      - `uuid` string, uuid
    - `last_message_data` string
    - `note_count` integer
    - `star` string, nullable
    - `status` string
    - `team_id` integer
    - `unread_message_count` integer
    - `unread_note_count` integer
    - `update_date` string, date-time
    - `uuid` string, uuid
    - `waba_id` string
    - `window_start_date` string, date-time

## Other responses

- `401` — Unauthorized — access denied by the WhatsApp service.
- `404` — Not found — the specified account does not exist.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)