# analytics_messages_retrieve

Conversation list endpoint for analytics.

Query params (all optional unless specified by permissions):
- platform_key: filter by platform
- mentor_unique_id: filter by mentor
- page: page number (default 1)
- limit: page size (default 20, max 100)
- search: search in user name and first user message
- min_messages, max_messages: message_count range
- sentiment: positive|negative|neutral
- topic: topic name contains
- start_date, end_date: date filter on conversation date

Returns: summary totals, results list (paginated), and pagination metadata.

Endpoint: GET /api/analytics/messages/
Version: 4.84.1-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `end_date` (string)

  - `limit` (integer)

  - `max_messages` (integer)

  - `mentor_unique_id` (string)

  - `min_messages` (integer)

  - `page` (integer)

  - `platform_key` (string)

  - `search` (string)

  - `sentiment` (string)
    * positive - positive
* negative - negative
* neutral - neutral
    Enum: "positive", "negative", "neutral"

  - `start_date` (string)

  - `topic` (string)

## Response 200 fields (application/json):

  - `summary` (object, required)

  - `results` (array, required)

  - `results.platform_name` (string, required)

  - `results.platform_key` (string, required)

  - `results.mentor` (string, required)

  - `results.mentor_unique_id` (string, required)

  - `results.model` (string, required)

  - `results.cost` (string, required)

  - `results.username` (string,null)

  - `results.name` (string, required)

  - `results.first_user_message` (string,null)

  - `results.topics` (any, required)

  - `results.message_count` (integer, required)

  - `results.user_queries` (integer,null)

  - `results.assistant_responses` (integer,null)

  - `results.average_sentiment` (number,null)

  - `results.sentiment` (string,null)

  - `results.created_at` (string, required)

  - `results.platform` (integer, required)

  - `results.session` (string, required)

  - `results.user` (integer,null)
    edX user ID

  - `pagination` (object, required)