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

Retrieve a conversation

Retrieves a conversation by its identifier. Use conversation_id to get the conversation's metadata and creation time.

1 parameter
conversation_idstringrequired
The unique identifier of the conversation to retrieve.

3 status codes
200Returns the conversation with its unique identifier, object type, metadata, and creation time.
idstringrequired
The unique ID of the conversation.
objectstringrequired
The object type, which is always `conversation`.
Allowed:conversationDefault:conversation
metadataobjectrequired
Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
created_atintegerrequired
The time at which the conversation was created, measured in seconds since the Unix epoch.
404Returned when the conversation is not found.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired

Error handling

A 404 is returned when the conversation is not found, and a 429 indicates that the request exceeded a rate limit. The conversation_id path parameter must identify the conversation to retrieve.