OpenAI API (unofficial showcase)
GET/conversations/{conversation_id}/items/{item_id}

Retrieve an item from a conversation

Retrieves a single item from a conversation. Use conversation_id and item_id to identify the conversation and the item you want to inspect.

3 parameters
conversation_idstringrequired
The identifier of the conversation that contains the item.
item_idstringrequired
The identifier of the item to retrieve.
includearray<string>optional
Additional response data to include: `file_search_call.results`, `web_search_call.results`, `web_search_call.action.sources`, `message.input_image.image_url`, `computer_call_output.output.image_url`, `code_interpreter_call.outputs`, `reasoning.encrypted_content`, or `message.output_text.logprobs`.

3 status codes
200Returns the requested conversation item, whose type determines its item-specific fields.
typestringrequired
The type of the message. Always set to `message`.
Allowed:messageDefault:message
idstringrequired
The unique ID of the message.
statusstringrequired
The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.
Allowed:in_progresscompletedincomplete
rolestringrequired
The role of the message. One of `unknown`, `user`, `assistant`, `system`, `critic`, `discriminator`, `developer`, or `tool`.
Allowed:unknownuserassistantsystemcriticdiscriminatordevelopertool
contentarray<InputText>required
The content of the message
phasestringoptional
Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up requests, preserve and resend phase on all assistant messages — dropping it can degrade performance. Not used for user messages.
Allowed:commentaryfinal_answer
404Returned when the conversation or the item in that conversation was not found.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired

Error handling

A 404 is returned when the conversation or the item in that conversation was not found. A 429 is returned when the request exceeds a rate limit. The conversation_id and item_id path parameters must identify the conversation and item to retrieve.