---
title: "Retrieve all entries in a conversation."
method: GET
path: "/v1/conversations/{conversation_id}/history"
tags: ["beta.conversations"]
---

# Retrieve all entries in a conversation.

`GET /v1/conversations/{conversation_id}/history`

## Request

- Base URL: `https://api.mistral.ai`
- URL: `https://api.mistral.ai/v1/conversations/{conversation_id}/history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/conversations/:conversation_id/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Given a conversation_id retrieve all the entries belonging to that conversation. The entries are sorted in the order they were appended, those can be messages, connectors or function_call.

## Path parameters

- `conversation_id` string, required: ID of the conversation from which we are fetching entries.

## Response `200`

Successful Response

- ConversationHistory: Retrieve all entries in a conversation.
  - `object` 'conversation.history'
  - `conversation_id` string, required
  - `entries` union[], required
    - union
      - MessageInputEntry: Representation of an input message inside the conversation.
        - `object` 'entry'
        - `type` 'message.input'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `id` string
        - `role` 'assistant' | 'user', required
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `prefix` boolean
      - MessageOutputEntry
        - `object` 'entry'
        - `type` 'message.output'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `agent_id` string, nullable
        - `model` string, nullable
        - `id` string
        - `role` 'assistant'
        - `content` union, required
          - string
          - union[]
            - union
              - …
      - FunctionResultEntry
        - `object` 'entry'
        - `type` 'function.result'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `id` string
        - `tool_call_id` string, required
        - `result` string, required
      - FunctionCallEntry
        - `object` 'entry'
        - `type` 'function.call'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `agent_id` string, nullable
        - `model` string, nullable
        - `id` string
        - `tool_call_id` string, required
        - `name` string, required
        - `arguments` union, required
          - object
          - string
        - `confirmation_status` 'pending' | 'allowed' | 'denied', nullable
      - ToolExecutionEntry
        - `object` 'entry'
        - `type` 'tool.execution'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `agent_id` string, nullable
        - `model` string, nullable
        - `id` string
        - `name` union, required
          - 'web_search' | 'web_search_premium' | 'code_interpreter' | 'image_generation' | 'document_library' | 'mistral_mcp'
          - string
        - `arguments` string, required
        - `info` ToolExecutionInfo
      - AgentHandoffEntry
        - `object` 'entry'
        - `type` 'agent.handoff'
        - `created_at` string, date-time
        - `completed_at` string, date-time, nullable
        - `id` string
        - `previous_agent_id` string, required
        - `previous_agent_name` string, required
        - `next_agent_id` string, required
        - `next_agent_name` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-12** `6c349f3bdef6`: 6 warning
  - added the new `mistral_mcp` enum value to the `entries/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `entries/items/anyOf[subschema #1: MessageInputEntry]/content/anyOf[subschema #2: MessageInputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #2: ToolReferenceChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `entries/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #3: ToolFileChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - added the new `mistral_mcp` enum value to the `entries/items/anyOf[subschema #2: MessageOutputEntry]/content/anyOf[subschema #2: MessageOutputContentChunks]/items/anyOf[subschema #5: ThinkChunk]/thinking/items/anyOf[subschema #2: ToolReferenceChunk]/tool/anyOf[subschema #1: BuiltInConnectors]/` response property for the response status `200`
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/conversations/:conversation_id/history/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/08a585fb75bc?raw)