---
title: "Get Conversations"
method: POST
path: "/telephony/message/conversations"
---

# Get Conversations

`POST /telephony/message/conversations`

## Headers

- `x-api-key` string, required

## Request body

- object
  - `filters` object, required
    - `keyword` string
    - `customer_number_uid` string[], required
    - `phone_number_uid` string[], required
    - `status` 'OPEN' | 'CLOSED', required
    - `needs_attention` boolean
    - `read_status` 'READ' | 'UNREAD'
    - `response_status` 'UNRESPONDED' | 'RESPONDED'
  - `page` number, required
  - `limit` number, required

## Response `200`

- object
  - `type` string
  - `data` object[]
    - `conversation_uid` string
    - `is_done` boolean
    - `has_unread` boolean
    - `unread_count` integer
    - `needs_attention` boolean
    - `is_unresponded` boolean
    - `meta_data` unknown
    - `recent_conversation_at` string
    - `updated_at` string
    - `created_at` string
    - `recent_message` unknown
    - `recent_call` object
      - `call_uid` string
      - `direction` string
      - `status` string
      - `call_recordings` object[]
        - `recording_url` string
        - `recording_duration` integer
        - `call_summary` object
          - `status` string
          - `summary` string
          - `sentiment` string
          - `next_action` string[]
          - `confidence` number
    - `unread_message` object
      - `message_uid` string
      - `message_type` string
      - `message` unknown
      - `media` object[]
      - `direction` string
    - `customer_number` object
      - `customer_number_uid` string
      - `customer_uid` string
      - `customer_full_name` string
      - `customer_email` string
      - `number` string
      - `number_type` string
      - `is_blocked` boolean
      - `created_at` string
      - `updated_at` string
    - `number` object
      - `number` string
      - `display_name` string
      - `number_uid` string
    - `recent_conversation_user` object
      - `user_uid` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `profile_picture` string
    - `assigned_user` object
      - `user_uid` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `profile_picture` string
  - `total_records` integer
  - `total_pages` integer
  - `current_page` integer

---

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