---
title: "Get Response Input Items"
method: GET
path: "/responses/{response_id}/input_items"
tags: ["responses"]
---

# Get Response Input Items

`GET /responses/{response_id}/input_items`

## Request

- Base URL: `https://api.mammouth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mammouth.ai/responses/{response_id}/input_items`
- Auth: API key in header `x-litellm-api-key`
- TypeScript: <https://skmtc.dev/mammouth/apis/mammouth-api/docs/responses/:response_id/input_items/get.ts> (a function with typed inputs; its response is checked against the schema)

List input items for a response.

## Path parameters

- `response_id` string, required

## Response `200`

Successful Response

- ResponseItemList: A list of Response items.
  - `data` union[], required
    - union
      - ResponseInputMessageItem
        - `id` string, required
        - `content` union[], required
          - union
            - ResponseInputText: A text input to the model.
              - …
            - ResponseInputImage: An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision).
              - …
            - ResponseInputFile: A file input to the model.
              - …
        - `role` 'user' | 'system' | 'developer', required
        - `type` 'message', required
        - `status` 'in_progress' | 'completed' | 'incomplete', nullable
      - ResponseOutputMessage: An output message from the model.
        - `id` string, required
        - `content` union[], required
          - union
            - ResponseOutputText: A text output from the model.
              - …
            - ResponseOutputRefusal: A refusal from the model.
              - …
        - `role` 'assistant', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'message', required
        - `phase` 'commentary' | 'final_answer', nullable
      - ResponseFileSearchToolCall: The results of a file search tool call. See the [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more information.
        - `id` string, required
        - `queries` string[], required
        - `status` 'in_progress' | 'searching' | 'completed' | 'incomplete' | 'failed', required
        - `type` 'file_search_call', required
        - `results` Result[], nullable
          - `attributes` object, nullable
          - `file_id` string, nullable
          - `filename` string, nullable
          - `score` number, nullable
          - `text` string, nullable
      - ResponseComputerToolCall: A tool call to a computer use tool. See the [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more information.
        - `id` string, required
        - `call_id` string, required
        - `pending_safety_checks` PendingSafetyCheck[], required
          - `id` string, required
          - `code` string, nullable
          - `message` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'computer_call', required
        - `action` union
          - ActionClick: A click action.
            - `button` 'left' | 'right' | 'wheel' | 'back' | 'forward', required
            - `type` 'click', required
            - `x` integer, required
            - `y` integer, required
            - `keys` string[], nullable
          - ActionDoubleClick: A double click action.
            - `keys` string[], nullable
            - `type` 'double_click', required
            - `x` integer, required
            - `y` integer, required
          - ActionDrag: A drag action.
            - `path` ActionDragPath[], required
              - …
            - `type` 'drag', required
            - `keys` string[], nullable
          - ActionKeypress: A collection of keypresses the model would like to perform.
            - `keys` string[], required
            - `type` 'keypress', required
          - ActionMove: A mouse move action.
            - `type` 'move', required
            - `x` integer, required
            - `y` integer, required
            - `keys` string[], nullable
          - ActionScreenshot: A screenshot action.
            - `type` 'screenshot', required
          - ActionScroll: A scroll action.
            - `scroll_x` integer, required
            - `scroll_y` integer, required
            - `type` 'scroll', required
            - `x` integer, required
            - `y` integer, required
            - `keys` string[], nullable
          - ActionType: An action to type in text.
            - `text` string, required
            - `type` 'type', required
          - ActionWait: A wait action.
            - `type` 'wait', required
        - `actions` union[], nullable
          - union
            - Click: A click action.
              - …
            - DoubleClick: A double click action.
              - …
            - Drag: A drag action.
              - …
            - Keypress: A collection of keypresses the model would like to perform.
              - …
            - Move: A mouse move action.
              - …
            - Screenshot: A screenshot action.
              - …
            - Scroll: A scroll action.
              - …
            - Type: An action to type in text.
              - …
            - Wait: A wait action.
              - …
      - ResponseComputerToolCallOutputItem
        - `id` string, required
        - `call_id` string, required
        - `output` ResponseComputerToolCallOutputScreenshot, required: A computer screenshot image used with the computer use tool.
          - `type` 'computer_screenshot', required
          - `file_id` string, nullable
          - `image_url` string, nullable
        - `status` 'completed' | 'incomplete' | 'failed' | 'in_progress', required
        - `type` 'computer_call_output', required
        - `acknowledged_safety_checks` AcknowledgedSafetyCheck[], nullable
          - `id` string, required
          - `code` string, nullable
          - `message` string, nullable
        - `created_by` string, nullable
      - ResponseFunctionWebSearch: The results of a web search tool call. See the [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more information.
        - `id` string, required
        - `action` union, required
          - ActionSearch: Action type "search" - Performs a web search query.
            - `query` string, required
            - `type` 'search', required
            - `queries` string[], nullable
            - `sources` ActionSearchSource[], nullable
              - …
          - ActionOpenPage: Action type "open_page" - Opens a specific URL from search results.
            - `type` 'open_page', required
            - `url` string, nullable
          - ActionFind: Action type "find_in_page": Searches for a pattern within a loaded page.
            - `pattern` string, required
            - `type` 'find_in_page', required
            - `url` string, required
        - `status` 'in_progress' | 'searching' | 'completed' | 'failed', required
        - `type` 'web_search_call', required
      - ResponseFunctionToolCallItem: A tool call to run a function. See the [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more information.
        - `arguments` string, required
        - `call_id` string, required
        - `name` string, required
        - `type` 'function_call', required
        - `id` string, required
        - `namespace` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `created_by` string, nullable
      - ResponseFunctionToolCallOutputItem
        - `id` string, required
        - `call_id` string, required
        - `output` union, required
          - string
          - union[]
            - union
              - …
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'function_call_output', required
        - `created_by` string, nullable
      - ResponseToolSearchCall
        - `id` string, required
        - `arguments` unknown, required
        - `call_id` string, nullable
        - `execution` 'server' | 'client', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'tool_search_call', required
        - `created_by` string, nullable
      - ResponseToolSearchOutputItem
        - `id` string, required
        - `call_id` string, nullable
        - `execution` 'server' | 'client', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `tools` union[], required
          - union
            - FunctionTool: Defines a function in your own code the model can choose to call. Learn more about [function calling](https://platform.openai.com/docs/guides/function-calling).
              - …
            - FileSearchTool: A tool that searches for relevant content from uploaded files. Learn more about the [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
              - …
            - ComputerTool: A tool that controls a virtual computer. Learn more about the [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
              - …
            - ComputerUsePreviewTool: A tool that controls a virtual computer. Learn more about the [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
              - …
            - WebSearchTool: Search the Internet for sources related to the prompt. Learn more about the [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
              - …
            - Mcp: Give the model access to additional tools via remote Model Context Protocol (MCP) servers. [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
              - …
            - CodeInterpreter: A tool that runs Python code to help generate a response to a prompt.
              - …
            - ImageGeneration: A tool that generates images using the GPT image models.
              - …
            - LocalShell: A tool that allows the model to execute shell commands in a local environment.
              - …
            - FunctionShellTool: A tool that allows the model to execute shell commands.
              - …
            - CustomTool: A custom tool that processes input using a specified format. Learn more about [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
              - …
            - NamespaceTool: Groups function/custom tools under a shared namespace.
              - …
            - ToolSearchTool: Hosted or BYOT tool search configuration for deferred tools.
              - …
            - WebSearchPreviewTool: This tool searches the web for relevant results to use in a response. Learn more about the [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
              - …
            - ApplyPatchTool: Allows the assistant to create, delete, or update files using unified diffs.
              - …
        - `type` 'tool_search_output', required
        - `created_by` string, nullable
      - ResponseReasoningItem: A description of the chain of thought used by a reasoning model while generating a response. Be sure to include these items in your `input` to the Responses API for subsequent turns of a conversation if you are manually [managing context](https://platform.openai.com/docs/guides/conversation-state).
        - `id` string, required
        - `summary` Summary[], required
          - `text` string, required
          - `type` 'summary_text', required
        - `type` 'reasoning', required
        - `content` Content[], nullable
          - `text` string, required
          - `type` 'reasoning_text', required
        - `encrypted_content` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete', nullable
      - ResponseCompactionItem: A compaction item generated by the [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
        - `id` string, required
        - `encrypted_content` string, required
        - `type` 'compaction', required
        - `created_by` string, nullable
      - ImageGenerationCall: An image generation request made by the model.
        - `id` string, required
        - `result` string, nullable
        - `status` 'in_progress' | 'completed' | 'generating' | 'failed', required
        - `type` 'image_generation_call', required
      - ResponseCodeInterpreterToolCall: A tool call to run code.
        - `id` string, required
        - `code` string, nullable
        - `container_id` string, required
        - `outputs` union[], nullable
          - union
            - OutputLogs: The logs output from the code interpreter.
              - …
            - OutputImage: The image output from the code interpreter.
              - …
        - `status` 'in_progress' | 'completed' | 'incomplete' | 'interpreting' | 'failed', required
        - `type` 'code_interpreter_call', required
      - LocalShellCall: A tool call to run a command on the local shell.
        - `id` string, required
        - `action` LocalShellCallAction, required: Execute a shell command on the server.
          - `command` string[], required
          - `env` object, required
          - `type` 'exec', required
          - `timeout_ms` integer, nullable
          - `user` string, nullable
          - `working_directory` string, nullable
        - `call_id` string, required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'local_shell_call', required
      - LocalShellCallOutput: The output of a local shell tool call.
        - `id` string, required
        - `output` string, required
        - `type` 'local_shell_call_output', required
        - `status` 'in_progress' | 'completed' | 'incomplete', nullable
      - ResponseFunctionShellToolCall: A tool call that executes one or more shell commands in a managed environment.
        - `id` string, required
        - `action` Action, required: The shell commands and limits that describe how to run the tool call.
          - `commands` string[], required
          - `max_output_length` integer, nullable
          - `timeout_ms` integer, nullable
        - `call_id` string, required
        - `environment` union
          - ResponseLocalEnvironment: Represents the use of a local environment to perform shell actions.
            - `type` 'local', required
          - ResponseContainerReference: Represents a container created with /v1/containers.
            - `container_id` string, required
            - `type` 'container_reference', required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'shell_call', required
        - `created_by` string, nullable
      - ResponseFunctionShellToolCallOutput: The output of a shell tool call that was emitted.
        - `id` string, required
        - `call_id` string, required
        - `max_output_length` integer, nullable
        - `output` Output[], required
          - `outcome` union, required
            - OutputOutcomeTimeout: Indicates that the shell call exceeded its configured time limit.
              - …
            - OutputOutcomeExit: Indicates that the shell commands finished and returned an exit code.
              - …
          - `stderr` string, required
          - `stdout` string, required
          - `created_by` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `type` 'shell_call_output', required
        - `created_by` string, nullable
      - ResponseApplyPatchToolCall: A tool call that applies file diffs by creating, deleting, or updating files.
        - `id` string, required
        - `call_id` string, required
        - `operation` union, required
          - OperationCreateFile: Instruction describing how to create a file via the apply_patch tool.
            - `diff` string, required
            - `path` string, required
            - `type` 'create_file', required
          - OperationDeleteFile: Instruction describing how to delete a file via the apply_patch tool.
            - `path` string, required
            - `type` 'delete_file', required
          - OperationUpdateFile: Instruction describing how to update a file via the apply_patch tool.
            - `diff` string, required
            - `path` string, required
            - `type` 'update_file', required
        - `status` 'in_progress' | 'completed', required
        - `type` 'apply_patch_call', required
        - `created_by` string, nullable
      - ResponseApplyPatchToolCallOutput: The output emitted by an apply patch tool call.
        - `id` string, required
        - `call_id` string, required
        - `status` 'completed' | 'failed', required
        - `type` 'apply_patch_call_output', required
        - `created_by` string, nullable
        - `output` string, nullable
      - McpListTools: A list of tools available on an MCP server.
        - `id` string, required
        - `server_label` string, required
        - `tools` McpListToolsTool[], required
          - `input_schema` unknown, required
          - `name` string, required
          - `annotations` unknown
          - `description` string, nullable
        - `type` 'mcp_list_tools', required
        - `error` string, nullable
      - McpApprovalRequest: A request for human approval of a tool invocation.
        - `id` string, required
        - `arguments` string, required
        - `name` string, required
        - `server_label` string, required
        - `type` 'mcp_approval_request', required
      - McpApprovalResponse: A response to an MCP approval request.
        - `id` string, required
        - `approval_request_id` string, required
        - `approve` boolean, required
        - `type` 'mcp_approval_response', required
        - `reason` string, nullable
      - McpCall: An invocation of a tool on an MCP server.
        - `id` string, required
        - `arguments` string, required
        - `name` string, required
        - `server_label` string, required
        - `type` 'mcp_call', required
        - `approval_request_id` string, nullable
        - `error` string, nullable
        - `output` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete' | 'calling' | 'failed', nullable
      - ResponseCustomToolCallItem: A call to a custom tool created by the model.
        - `call_id` string, required
        - `input` string, required
        - `name` string, required
        - `type` 'custom_tool_call', required
        - `id` string, required
        - `namespace` string, nullable
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `created_by` string, nullable
      - ResponseCustomToolCallOutputItem: The output of a custom tool call from your code, being sent back to the model.
        - `call_id` string, required
        - `output` union, required
          - string
          - union[]
            - union
              - …
        - `type` 'custom_tool_call_output', required
        - `id` string, required
        - `status` 'in_progress' | 'completed' | 'incomplete', required
        - `created_by` string, nullable
  - `first_id` string, required
  - `has_more` boolean, required
  - `last_id` string, required
  - `object` 'list', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `8efc7e7a4ee4`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `data` to the response with the `200` status
  - added the required property `first_id` to the response with the `200` status
  - added the required property `has_more` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/mammouth/apis/mammouth-api/changes/responses/:response_id/input_items/get.md)

---

[API](https://skmtc.dev/mammouth/apis/mammouth-api.md) - [All operations](https://skmtc.dev/mammouth/apis/mammouth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mammouth/apis/mammouth-api/revisions/0221c7d45bb1?raw)