List input items

Returns a list of input items for a given response.

GET /responses/{response_id}/input_items

List input items

cURL

curl --request GET \
  --url https://api.openai.com/v1/responses/{response_id}/input_items \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "list",
  "data": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "<string>"
        }
      ],
      "id": "<string>",
      "type": "message",
      "status": "in_progress"
    }
  ],
  "has_more": true,
  "first_id": "<string>",
  "last_id": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

response_id · string · required

The ID of the response to retrieve input items for.

Query Parameters

limit · integer · default: 20

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

order · enum<string>

The order to return the input items in. Default is asc.

• asc: Return the input items in ascending order.
• desc: Return the input items in descending order.

Available options: asc, desc

after · string

An item ID to list items after, used in pagination.

before · string

An item ID to list items before, used in pagination.

include · enum<string>[]

Additional fields to include in the response. See the include parameter for Response creation above for more information.

Specify additional output data to include in the model response. Currently supported values are:

• file_search_call.results: Include the search results of the file search tool call.
• message.input_image.image_url: Include image urls from the input message.
• computer_call_output.output.image_url: Include image urls from the computer call output.

Available options: file_search_call.results, message.input_image.image_url, computer_call_output.output.image_url

Response

200 - application/json

OK

A list of Response items.

object · enum<string> · required

The type of object returned, must be list.

Available options: list

data · (Input message · object | Output message · object | File search tool call · object | Computer tool call · object | Computer tool call output · object | Web search tool call · object | Function tool call · object | Function tool call output · object)[] · required

A list of items used to generate this response.

Content item used to generate a response.

Input message

Output message

File search tool call

Computer tool call

Computer tool call output

Web search tool call

Function tool call

Function tool call output

Show child attributes

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.