---
title: "List messages from a conversation"
method: GET
path: "/conversations/{convId}/messages"
tags: ["messages"]
---

# List messages from a conversation

`GET /conversations/{convId}/messages`

Returns the first 100 messages in a specific conversation by default. Use `limit_count` and `last_id_returned` to paginate through results.

**Permission:** `Conversations Read` required.

**Monitoring:** Optional. With Monitoring **OFF**, only non-archived messages are returned. With Monitoring **ON**, all messages are returned including archived ones (you can also use the `display_archived` parameter).

## Path parameters

- `convId` integer, required

## Query parameters

- `limit_count` integer
- `last_id_returned` integer
- `display_archived` boolean

## Response `200`

Successful operation — the message list is returned.

- ConversationMessageList
  - `conversation_id` integer
  - `is_sms_write` boolean — Allows to send SMS
  - `type` 'INTERNAL' | 'EXTERNAL' | 'COLLABORATIVE'
  - `name` string
  - `purpose` string
  - `unread_messages_count` integer
  - `last_id_returned_setted` integer
  - `limit_count_setted` integer
  - `total_messages_count` integer
  - `message_list_count` integer
  - `message_list` Message[]
    - `message_id` integer
    - `mdr_uuid` string — is displayed for external conversations
    - `thread` object
      - `thread_uuid` string
      - `conversation_id_linked` integer
      - `conversation_sms_id_linked` integer
      - `nb_response` integer
      - `buffer_section` integer
    - `conversation_id` integer
    - `conversation_user_id` integer
    - `user` UserLight
      - `user_id` integer — The user identifier
      - `team_id` integer — The team identifier of the user
      - `initial` string — The initials of the user
      - `color` string
      - `firstname` string — The firstname of the user
      - `lastname` string — The lastname of the user
      - `company` string — The company of the user
      - `email` string — The email of the user
      - `picture` string — The picture of the user
      - `concat_name` string
    - `contact` Contact
      - `contact_id` integer
      - `is_shared` boolean
      - `im_owner` string
      - `social_service` string, nullable
      - `social_service_id` string
      - `social_profile_url` string, nullable
      - `social_data` string, nullable
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `color` string
      - `initial` string
      - `profile_picture` string, nullable
      - `creation_date` string, date-time
      - `numbers` integer[], nullable
    - `number` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
    - `buffer` string — Content of the message
    - `total_price` integer — Is `null` if the conversation is internal
    - `total_plan` integer — Is `null` if the conversation is internal
    - `is_failed` boolean
    - `nb_fragments` integer — Depends on the number of characters sent
    - `direction` 'IN' | 'OUT', nullable
    - `is_archived` boolean
    - `archive_date` string, date-time
    - `creation_date` string, date-time
    - `update_date` string, date-time
  - `is_archived` boolean — Archived flag
  - `creation_date` string, date-time
  - `update_date` string, date-time

## Other responses

- `204` — No messages found in this conversation.
- `400` — Invalid query parameters or conversation ID.
- `401` — Unauthorized — missing or invalid API token, or missing `Conversations Read` permission.
- `404` — Conversation not found — no conversation matches the provided ID.
- `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)