> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить сообщения переписки

> Возвращает страницу сообщений доступной личной переписки.

Возвращает страницу сообщений доступной личной переписки.

Сообщения возвращаются по времени отправки. Чтение этой страницы не вызывает отдельную отметку переписки прочитанной; используйте [mark-read](/guard-forum/api/post-conversations-id-mark-read).

## Доступ

Передавайте `XF-Api-Key` в заголовке каждого запроса. [Типы ключей и выбор пользователя](/guard-forum/authentication).

Требуемые scopes: `conversation:read`. Все перечисленные разрешения нужны одновременно.

Нужен контекст зарегистрированного пользователя. Для Super key укажите `XF-Api-User`; доступ к объектам и действиям проверяется отдельно от scopes.

## Параметры

<ParamField header="XF-Api-Key" type="string" required>
  Секретный API-ключ. В примерах ключ берётся из серверной переменной `$FORUM_API_KEY`.
</ParamField>

<ParamField path="id" type="integer" required>
  Идентификатор переписки.
</ParamField>

<ParamField query="page" type="integer">
  Номер страницы. Размер страницы задаётся настройками форума; отдельного параметра `per_page` у этого метода нет.
</ParamField>

## Ответ

HTTP `200`, JSON. [Схемы объектов и условные поля](/guard-forum/models).

<ResponseField name="messages" type="ConversationMessage[]">
  Массив сообщений запрошенной страницы.
</ResponseField>

<ResponseField name="pagination" type="pagination">
  Сведения о странице: `current_page`, `last_page`, `per_page`, `shown`, `total`.
</ResponseField>

Ошибки возвращаются в общей структуре `errors`. Обрабатывайте поле `code`; текст `message` может меняться или переводиться. [Формат ошибок](/guard-forum/requests-and-errors).

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET 'https://forum.arzguard.com/api/conversations/123/messages' \
    --header "XF-Api-Key: $FORUM_API_KEY" \
    --get \
    --data-urlencode 'page=1'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 · условный пример theme={null}
  {
    "messages": [
      {
        "message_id": 123,
        "conversation_id": 123,
        "message": "Пример сообщения"
      }
    ],
    "pagination": {
      "current_page": 1,
      "last_page": 1,
      "per_page": 20,
      "shown": 1,
      "total": 1
    }
  }
  ```
</ResponseExample>

Примеры сокращены и содержат только условные значения. Состав полей объектов зависит от прав, контекста и установленных дополнений.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.