---
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`

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'
          - 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

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)