--- title: "Returns a list of input items for a given response." method: GET path: "/responses/{response_id}/input_items" tags: ["Responses"] --- # Returns a list of input items for a given response. `GET /responses/{response_id}/input_items` ## Path parameters - `response_id` string, required ## Query parameters - `limit` integer - `order` 'asc' | 'desc' - `after` string - `before` string ## Response `200` OK - ResponseItemList — A list of Response items. - `object` 'list', required — The type of object returned, must be `list`. - `data` ItemResource[], required — A list of items used to generate this response. - union — Content item used to generate a response. - object — A message input to the model with a role indicating instruction following hierarchy. Instructions given with the `developer` or `system` role take precedence over instructions given with the `user` role. - `type` 'message' — The type of the message input. Always set to `message`. - `role` 'user' | 'system' | 'developer', required — The role of the message input. One of `user`, `system`, or `developer`. - `status` 'in_progress' | 'completed' | 'incomplete' — The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API. - `content` InputContent[], required — A list of one or many input items to the model, containing different content types. - union - object — A text input to the model. - … - object — An image input to the model. Learn about [image inputs](/docs/guides/vision). - … - object — A file input to the model. - … - `id` string, required — The unique ID of the message input. - object — An output message from the model. - `id` string, required — The unique ID of the output message. - `type` 'message', required — The type of the output message. Always `message`. - `role` 'assistant', required — The role of the output message. Always `assistant`. - `content` OutputContent[], required — The content of the output message. - union - OutputText — A text output from the model. - … - Refusal — A refusal from the model. - … - `status` 'in_progress' | 'completed' | 'incomplete', required — The status of the message input. One of `in_progress`, `completed`, or `incomplete`. Populated when input items are returned via API. - object — The results of a file search tool call. See the [file search guide](/docs/guides/tools-file-search) for more information. - `id` string, required — The unique ID of the file search tool call. - `type` 'file_search_call', required — The type of the file search tool call. Always `file_search_call`. - `status` 'in_progress' | 'searching' | 'completed' | 'incomplete' | 'failed', required — The status of the file search tool call. One of `in_progress`, `searching`, `incomplete` or `failed`, - `queries` string[], required — The queries used to search for files. - `results` object[], nullable — The results of the file search tool call. - `file_id` string — The unique ID of the file. - `text` string — The text that was retrieved from the file. - `filename` string — The name of the file. - `attributes` VectorStoreFileAttributes, nullable — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers. - `score` number, float — The relevance score of the file - a value between 0 and 1. - object — A tool call to a computer use tool. See the [computer use guide](/docs/guides/tools-computer-use) for more information. - `type` 'computer_call', required — The type of the computer call. Always `computer_call`. - `id` string, required — The unique ID of the computer call. - `call_id` string, required — An identifier used when responding to the tool call with output. - `action` union, required - Click — A click action. - `type` 'click', required — Specifies the event type. For a click action, this property is always set to `click`. - `button` 'left' | 'right' | 'wheel' | 'back' | 'forward', required — Indicates which mouse button was pressed during the click. One of `left`, `right`, `wheel`, `back`, or `forward`. - `x` integer, required — The x-coordinate where the click occurred. - `y` integer, required — The y-coordinate where the click occurred. - DoubleClick — A double click action. - `type` 'double_click', required — Specifies the event type. For a double click action, this property is always set to `double_click`. - `x` integer, required — The x-coordinate where the double click occurred. - `y` integer, required — The y-coordinate where the double click occurred. - Drag — A drag action. - `type` 'drag', required — Specifies the event type. For a drag action, this property is always set to `drag`. - `path` Coordinate[], required — An array of coordinates representing the path of the drag action. Coordinates will appear as an array of objects, eg ``` [ { x: 100, y: 200 }, { x: 200, y: 300 } ] ``` - … - KeyPress — A collection of keypresses the model would like to perform. - `type` 'keypress', required — Specifies the event type. For a keypress action, this property is always set to `keypress`. - `keys` string[], required — The combination of keys the model is requesting to be pressed. This is an array of strings, each representing a key. - Move — A mouse move action. - `type` 'move', required — Specifies the event type. For a move action, this property is always set to `move`. - `x` integer, required — The x-coordinate to move to. - `y` integer, required — The y-coordinate to move to. - Screenshot — A screenshot action. - `type` 'screenshot', required — Specifies the event type. For a screenshot action, this property is always set to `screenshot`. - Scroll — A scroll action. - `type` 'scroll', required — Specifies the event type. For a scroll action, this property is always set to `scroll`. - `x` integer, required — The x-coordinate where the scroll occurred. - `y` integer, required — The y-coordinate where the scroll occurred. - `scroll_x` integer, required — The horizontal scroll distance. - `scroll_y` integer, required — The vertical scroll distance. - Type — An action to type in text. - `type` 'type', required — Specifies the event type. For a type action, this property is always set to `type`. - `text` string, required — The text to type. - Wait — A wait action. - `type` 'wait', required — Specifies the event type. For a wait action, this property is always set to `wait`. - `pending_safety_checks` ComputerToolCallSafetyCheck[], required — The pending safety checks for the computer call. - `id` string, required — The ID of the pending safety check. - `code` string, required — The type of the pending safety check. - `message` string, required — Details about the pending safety check. - `status` 'in_progress' | 'completed' | 'incomplete', required — The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API. - object — The output of a computer tool call. - `type` 'computer_call_output', required — The type of the computer tool call output. Always `computer_call_output`. - `id` string, required — The unique ID of the computer call tool output. - `call_id` string, required — The ID of the computer tool call that produced the output. - `acknowledged_safety_checks` ComputerToolCallSafetyCheck[] — The safety checks reported by the API that have been acknowledged by the developer. - `id` string, required — The ID of the pending safety check. - `code` string, required — The type of the pending safety check. - `message` string, required — Details about the pending safety check. - `output` ComputerScreenshotImage, required — A computer screenshot image used with the computer use tool. - `type` 'computer_screenshot', required — Specifies the event type. For a computer screenshot, this property is always set to `computer_screenshot`. - `image_url` string — The URL of the screenshot image. - `file_id` string — The identifier of an uploaded file that contains the screenshot. - `status` 'in_progress' | 'completed' | 'incomplete' — The status of the message input. One of `in_progress`, `completed`, or `incomplete`. Populated when input items are returned via API. - object — The results of a web search tool call. See the [web search guide](/docs/guides/tools-web-search) for more information. - `id` string, required — The unique ID of the web search tool call. - `type` 'web_search_call', required — The type of the web search tool call. Always `web_search_call`. - `status` 'in_progress' | 'searching' | 'completed' | 'failed', required — The status of the web search tool call. - object — A tool call to run a function. See the [function calling guide](/docs/guides/function-calling) for more information. - `id` string, required — The unique ID of the function tool call. - `type` 'function_call', required — The type of the function tool call. Always `function_call`. - `call_id` string, required — The unique ID of the function tool call generated by the model. - `name` string, required — The name of the function to run. - `arguments` string, required — A JSON string of the arguments to pass to the function. - `status` 'in_progress' | 'completed' | 'incomplete' — The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API. - object — The output of a function tool call. - `id` string, required — The unique ID of the function call tool output. - `type` 'function_call_output', required — The type of the function tool call output. Always `function_call_output`. - `call_id` string, required — The unique ID of the function tool call generated by the model. - `output` string, required — A JSON string of the output of the function tool call. - `status` 'in_progress' | 'completed' | 'incomplete' — The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API. - `has_more` boolean, required — Whether there are more items available. - `first_id` string, required — The ID of the first item in the list. - `last_id` string, required — The ID of the last item in the list. ## Changes - **2025-03-22** `86ed5d923809` — 1 breaking - removed 'propertyNames' constraint from the `data/items/oneOf[subschema #3: File search tool call]/results/items/attributes` response property for the status `200` - **2025-03-22** `41844462b873` — 1 breaking, 1 info - added `#/components/schemas/FunctionToolCallResource` to the `data/items/` response property `oneOf` list for the response status `200` - removed `#/components/schemas/FunctionToolCall` from the `data/items/` response property `oneOf` list for the response status `200` - **2025-03-11** `6ab43fe7798e` — 1 info - endpoint added - **2024-08-23** `5856f8b0c850` — 1 breaking - api path removed without deprecation [Change history](https://skmtc.dev/openai/apis/openapi/changes/responses/:response_id/input_items/get.md) --- [API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/openapi/revisions/86ed5d923809/schema)