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

# List messages

> Retrieve the full message history for a conversation

<ParamField path="conversation_id" type="integer" required>
  Conversation ID.
</ParamField>

<ResponseField name="data" type="Message[]" required>
  Page of messages.
</ResponseField>

<ResponseField name="data[].id" type="integer" required>
  Message ID.
</ResponseField>

<ResponseField name="data[].sender" type="&#x22;user&#x22; | &#x22;agent&#x22;" required>
  Who sent the message.
</ResponseField>

<ResponseField name="data[].content" type="string" required>
  Message text.
</ResponseField>

<ResponseField name="data[].tool_calls" type="array">
  Tool calls made by the agent.
</ResponseField>

<ResponseField name="data[].metadata" type="object">
  Key-value metadata.
</ResponseField>

<ResponseField name="data[].timestamp" type="string">
  ISO 8601 timestamp.
</ResponseField>

## SDK

<CodeGroup>
  ```typescript TypeScript theme={null}
  const page = await client.messages.list(91);
  ```

  ```python Python theme={null}
  page = await client.messages.list(91)
  ```
</CodeGroup>