Skip to main content
GET
/
api
/
v1
/
chats
/
{chat_id}
curl "https://api.deeptrace.com/api/v1/chats/baa1b1be-4905-4448-9a37-159f08dfc570" \
  -H "Authorization: Bearer <your_api_key>"

{
  "id": "baa1b1be-4905-4448-9a37-159f08dfc570",
  "created_at": "2026-03-10T12:00:00Z",
  "messages": [
    {"role": "user", "content": [{"type": "text", "text": "What errors are happening?"}]},
    {"role": "assistant", "content": [{"type": "text", "text": "Let me check your error tracking tools..."}]}
  ],
  "data_sources": [],
  "investigation_results": [],
  "citation_map": {}
}
Retrieve a chat by ID including the full conversation history and metadata.

​
Headers

​
Authorization
string
required
Bearer token with your Deeptrace API key. Format: Bearer <your_api_key>.

​
Parameters

​
chat_id
string
required
UUID of the chat, returned by Send Chat Message.
curl "https://api.deeptrace.com/api/v1/chats/baa1b1be-4905-4448-9a37-159f08dfc570" \
  -H "Authorization: Bearer <your_api_key>"

​
Returns

Returns the full chat object with conversation history, data sources, investigation results, and citation map. 
{
  "id": "baa1b1be-4905-4448-9a37-159f08dfc570",
  "created_at": "2026-03-10T12:00:00Z",
  "messages": [
    {"role": "user", "content": [{"type": "text", "text": "What errors are happening?"}]},
    {"role": "assistant", "content": [{"type": "text", "text": "Let me check your error tracking tools..."}]}
  ],
  "data_sources": [],
  "investigation_results": [],
  "citation_map": {}
}
​
id
string
UUID of the chat.
​
created_at
string
ISO 8601 timestamp of when the chat was created.
​
messages
object[]
Array of message objects with role and content fields. Content is an array of content blocks (e.g. {"type": "text", "text": "..."}).
​
data_sources
array
Data sources referenced during the chat.
​
investigation_results
array
Investigation results generated during the chat.
​
citation_map
object
Map of citation references to their source data.