Conversations

List items

List all items for a conversation with the given ID.

get/conversations/{conversation_id}/items

Path parameters

conversation_idstring required

Example:conv_123

The ID of the conversation to list items for.

Query parameters

limitinteger

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

order'asc' | 'desc'

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

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

afterstring

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

includeIncludeEnum[]

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

web_search_call.action.sources: Include the sources of the web search tool call.
code_interpreter_call.outputs: Includes the outputs of python code execution in code interpreter tool call items.
computer_call_output.output.image_url: Include image urls from the computer call output.
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.
message.output_text.logprobs: Include logprobs with assistant messages.
reasoning.encrypted_content: Includes an encrypted version of reasoning tokens in reasoning item outputs. This enables reasoning items to be used in multi-turn conversations when using the Responses API statelessly (like when the store parameter is set to false, or when an organization is enrolled in the zero data retention program).

Response

object'list' required

The type of object returned, must be list.

has_moreboolean required

Whether there are more items available.

first_idstring required

The ID of the first item in the list.

last_idstring required

The ID of the last item in the list.

Changes

Changed in 16 of the 163 revisions of this API.62162

Sep 25, 2026d86203de41ae2See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 16, 20262cd8933757a42See the full diff
- ○
  response property data/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_id deprecated
  response-property-deprecated
- ○
  response property data/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_id deprecated
  response-property-deprecated
Sep 10, 20262f07cb0091b46See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added subschema #1 to the /// response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed subschema #1 subschema #2 from the /// response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 8, 20266bfa471548022See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Sep 8, 2026185927e212ab12See the full diff
- ●
  added the new gpt-image-2.5-flare enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-flare enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-flare-2026-09-08 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-flare-2026-09-08 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-sunburst enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-sunburst enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new max enum value to the ///////// response property for the response status
  response-property-enum-value-added
- ●
  added the new max enum value to the ///////// response property for the response status
  response-property-enum-value-added
- ●
  added the new xhigh enum value to the ///////// response property for the response status
  response-property-enum-value-added
- ●
  added the new xhigh enum value to the ///////// response property for the response status
  response-property-enum-value-added
Sep 4, 2026d3d980dbba531See the full diff
- ●
  added the new incomplete enum value to the /// response property for the response status
  response-property-enum-value-added
Sep 3, 20269430b00d75b4111See the full diff
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Aug 29, 2026959ef977e1351See the full diff
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
Aug 28, 20265c81016c9be71See the full diff
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Aug 20, 20265de4ab93fa244See the full diff
- ●
  added the new gpt-image-2 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2-2026-04-21 enum value to the ////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new gpt-image-2-2026-04-21 enum value to the ////////// response property for the response status
  response-property-enum-value-added

Full history (16 revisions)