---
title: "Get conversation messages"
method: GET
path: "/ai/conversations/{conversation_id}/messages"
tags: ["Conversations"]
---

# Get conversation messages

`GET /ai/conversations/{conversation_id}/messages`

Retrieve messages for a specific conversation, including tool calls made by the assistant.

## Path parameters

- `conversation_id` string, required

## Query parameters

- `page[size]` integer
- `page[number]` integer

## Response `200`

Successful Response

- ConversationMessageListData
  - `data` ConversationMessage[], required
    - `created_at` string, date-time — The datetime the message was created on the conversation. This does not necesarily correspond to the time the message was sent. The best field to use to determine the time the end user experienced the message is `sent_at`.
    - `role` 'user' | 'assistant' | 'tool', required — The role of the message sender.
    - `sent_at` string, date-time — The datetime the message was sent to the end user.
    - `text` string, required — The message content. Can be null for tool calls.
    - `tool_calls` object[] — Optional tool calls made by the assistant.
      - `function` object, required
        - `arguments` string, required — JSON-formatted arguments to pass to the function.
        - `name` string, required — Name of the function to call.
      - `id` string, required — Unique identifier for the tool call.
      - `type` 'function', required — Type of the tool call.
  - `meta` Meta, required
    - `page_number` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required
    - `total_results` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)