Swagger Petstore - OpenAPI 3.0
GET/conversations/{conversation_id}/items

List conversation items

Lists all items in a conversation, including messages, tool calls, and outputs. Use limit, order, and after to control pagination and sorting. The include parameter allows you to request additional nested data such as search results, code outputs, or image URLs.

5 parameters
conversation_idstringrequired
The unique identifier of the conversation to list items from.
limitintegeroptional
Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order for items: `asc` for ascending or `desc` for descending. Defaults to `desc` when omitted.
Allowed:ascdesc
afterstringoptional
An item ID to list items after, used for pagination. Omit for the first page.
includearray<string>optional
Additional fields to include in the response, such as search results, code outputs, image URLs, or reasoning content. Specify as an array of field names.

2 status codes
200Returns a paginated list of conversation items with metadata including total count, first and last item IDs, and whether more items are available.
objectstringrequired
The type of object returned, must be `list`.
Allowed: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 rate limit is exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request rate limit is exceeded. conversation_id must identify an existing conversation. limit must be between 1 and 100; values outside this range are rejected. order must be either asc or desc.