Sample - OpenAI API
GET/conversations/{conversation_id}/items/{item_id}

Retrieve a conversation item

Retrieves one item from a conversation by its conversation and item identifiers. Use include when the response needs additional tool results, sources, media URLs, or log probabilities. The response contains the requested conversation item and its type-specific fields.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
conversation_idstringrequired
The unique identifier of the conversation containing the item.
item_idstringrequired
The unique identifier of the conversation item to retrieve.
includearray<string>optional
Additional output data to include, such as file-search results, web-search sources, code-interpreter outputs, input image URLs, or message log probabilities.

2 status codes
200Returns the requested conversation item with its type-specific content and metadata.
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
429Returned when the request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request rate exceeds the allowed limit. conversation_id and item_id must identify the conversation and item you want to retrieve, and values in include must use the supported option names.