Conversations

List items

Changed on

List all items for a conversation with the given ID.

get/conversations/{conversation_id}/items

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/conversations/{conversation_id}/items
  • Auth
    HTTP bearer

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

OK

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

  • 6f5c52c2ff04Revision changes
    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property //////// to the response with the status

    • info

      added the optional property //////// to the response with the status

    • info

      added the optional property //////// to the response with the status

  • f1af3e12b410Revision changes
    • info

      the response's property default value changed from gpt-image-1 to gpt-image-2 for the status

    • info

      the response's property default value changed from gpt-image-1 to gpt-image-2 for the status