---
title: "Retrieve an item."
method: GET
path: "/v1/conversations/{conversation_id}/items/{item_id}"
tags: ["Conversations"]
---

# Retrieve an item.

`GET /v1/conversations/{conversation_id}/items/{item_id}`

Retrieve a conversation item.

## Path parameters

- `conversation_id` string, required — The conversation identifier.
- `item_id` string, required — The item identifier.

## Query parameters

- `include` ConversationItemInclude[], nullable

## Response `200`

The conversation item.

- union
  - OpenAIResponseMessageOutput — Corresponds to the various Message types in the Responses API. They are all under one type because the Responses API gives them all the same "type" value, and there is no way to tell them apart in certain scenarios.
    - `content` union, required
      - string
      - union[]
        - union
          - OpenAIResponseInputMessageContentText — Text content for input messages in OpenAI response format.
            - `text` string, required
            - `type` 'input_text'
          - OpenAIResponseInputMessageContentImage — Image content for input messages in OpenAI response format.
            - `detail` union
              - …
            - `type` 'input_image'
            - `file_id` string, nullable
            - `image_url` string, nullable
          - OpenAIResponseInputMessageContentFile — File content for input messages in OpenAI response format.
            - `type` 'input_file'
            - `file_data` string, nullable
            - `file_id` string, nullable
            - `file_url` string, nullable
            - `filename` string, nullable
      - union[]
        - union
          - OpenAIResponseOutputMessageContentOutputTextOutput — Text content within an output message of an OpenAI response.
            - `text` string, required
            - `type` 'output_text'
            - `annotations` union[]
              - …
            - `logprobs` OpenAITokenLogProb[], nullable
              - …
          - OpenAIResponseContentPartRefusal — Refusal content within a streamed response part.
            - `type` 'refusal'
            - `refusal` string, required
    - `role` union, required
      - 'system'
      - 'developer'
      - 'user'
      - 'assistant'
    - `type` 'message'
    - `id` string, nullable
    - `status` string, nullable
  - OpenAIResponseOutputMessageWebSearchToolCallOutput — Web search tool call output message for OpenAI responses.
    - `id` string, required
    - `status` string, required
    - `type` 'web_search_call'
    - `action` union
      - WebSearchActionSearch — Web search action: performs a search query.
        - `type` 'search'
        - `query` string, required
        - `queries` string[], nullable
        - `sources` WebSearchSource[], nullable
          - `type` 'url'
          - `url` string, required
      - WebSearchActionOpenPage — Web search action: opens a specific URL from search results.
        - `type` 'open_page'
        - `url` string, nullable
      - WebSearchActionFind — Web search action: searches for a pattern within a loaded page.
        - `type` 'find_in_page'
        - `url` string, required
        - `pattern` string, required
  - OpenAIResponseOutputMessageFileSearchToolCall — File search tool call output message for OpenAI responses.
    - `id` string, required
    - `queries` string[], required
    - `status` string, required
    - `type` 'file_search_call'
    - `results` OpenAIResponseOutputMessageFileSearchToolCallResults[], nullable
      - `attributes` object, required
      - `file_id` string, required
      - `filename` string, required
      - `score` number, required
      - `text` string, required
  - OpenAIResponseOutputMessageFunctionToolCall — Function tool call output message for OpenAI responses.
    - `call_id` string, required
    - `name` string, required
    - `arguments` string, required
    - `type` 'function_call'
    - `id` string, nullable
    - `status` string, nullable
  - OpenAIResponseInputFunctionToolCallOutput — This represents the output of a function call that gets passed back to the model.
    - `call_id` string, required
    - `output` union, required
      - string
      - union[]
        - union
          - OpenAIResponseInputMessageContentText — Text content for input messages in OpenAI response format.
            - `text` string, required
            - `type` 'input_text'
          - OpenAIResponseInputMessageContentImage — Image content for input messages in OpenAI response format.
            - `detail` union
              - …
            - `type` 'input_image'
            - `file_id` string, nullable
            - `image_url` string, nullable
          - OpenAIResponseInputMessageContentFile — File content for input messages in OpenAI response format.
            - `type` 'input_file'
            - `file_data` string, nullable
            - `file_id` string, nullable
            - `file_url` string, nullable
            - `filename` string, nullable
    - `type` 'function_call_output'
    - `id` string, nullable
    - `status` string, nullable
  - OpenAIResponseMCPApprovalRequest — A request for human approval of a tool invocation.
    - `arguments` string, required
    - `id` string, required
    - `name` string, required
    - `server_label` string, required
    - `type` 'mcp_approval_request'
  - OpenAIResponseMCPApprovalResponse — A response to an MCP approval request.
    - `approval_request_id` string, required
    - `approve` boolean, required
    - `type` 'mcp_approval_response'
    - `id` string, nullable
    - `reason` string, nullable
  - OpenAIResponseOutputMessageMCPCall — Model Context Protocol (MCP) call output message for OpenAI responses.
    - `id` string, required
    - `type` 'mcp_call'
    - `arguments` string, required
    - `name` string, required
    - `server_label` string, required
    - `error` string, nullable
    - `output` string, nullable
  - OpenAIResponseOutputMessageMCPListTools — MCP list tools output message containing available tools from an MCP server.
    - `id` string, required
    - `type` 'mcp_list_tools'
    - `server_label` string, required
    - `tools` MCPListToolsTool[], required
      - `input_schema` object, required
      - `name` string, required
      - `description` string, nullable
  - OpenAIResponseOutputMessageReasoningItem — Reasoning output from the model, representing the model's thinking process.
    - `id` string, required — Unique identifier for the reasoning output item.
    - `summary` OpenAIResponseOutputMessageReasoningSummary[], required — Summary of the reasoning output.
      - `text` string, required — The summary text of the reasoning output.
      - `type` 'summary_text' — The type identifier, always 'summary_text'.
    - `type` 'reasoning' — The type identifier, always 'reasoning'.
    - `content` OpenAIResponseOutputMessageReasoningContent[], nullable — The reasoning content from the model.
      - `text` string, required — The reasoning text content from the model.
      - `type` 'reasoning_text' — The type identifier, always 'reasoning_text'.
    - `status` 'in_progress' | 'completed' | 'incomplete', nullable — The status of the reasoning output.
  - OpenAIResponseCompaction — A compaction item that summarizes prior conversation context.
    - `type` 'compaction'
    - `encrypted_content` string, required
    - `id` string, nullable

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/revisions/f3f783962256/schema)