GET
/conversations/{conversation_id}/itemsList conversation items
Lists the items stored in a conversation. Use after, limit, and order to page through the items, and use include to request additional tool or message output data. The response reports the returned items, their boundary identifiers, and whether more items are available.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
conversation_idstringrequired
The unique identifier of the conversation whose items to list.
limitintegeroptional
The number of items to return, from 1 to 100. Defaults to 20 when omitted.
orderstringoptional
The item sort order: `asc` for ascending or `desc` for descending. Defaults to `desc` when omitted.
afterstringoptional
The item identifier after which to continue pagination.
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.
200Returns a list object containing conversation items, the first and last item identifiers, and a `has_more` flag.
objectstringrequired
The type of object returned, must be `list`.
dataarray<ConversationItem>required
A list of conversation items.
has_morebooleanrequired
Whether there are more items available.
first_idstringrequired
The ID of the first item in the list.
last_idstringrequired
The ID of the last item in the list.
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. limit ranges from 1 to 100 and defaults to 20, while order must be asc or desc; conversation_id must identify the conversation to list.