Get Conversation Data Graph

Retrieves the full data graph for the specified conversation, including all ingested entries, participant state, and related artifacts.

URI: /api/v1/agentic/conversations/{conversationId}

HTTP Method: GET

Authentication: Bearer JWT

Path Parameters

Parameter	Required	Description
conversationId	Yes	Conversation identifier.

Query Parameters

Parameter	Required	Description
owner_id	Yes	End-user’s Individual ID.
agent_id	No	Agent identifier (also accepted as header).
session_id	No	Narrow retrieval to a specific session.
participant_id	No	Filter by participant ID.
owner_type	No	Type of profile (optional on this endpoint).
scope	No	Filter entry types. Values: `messages`, `traces`, or `all`.
page_token	No	Pagination token for retrieving next page.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer JWT token.
agent_id	Yes	Agent identifier.

Response Body Schema

Field	Type	Nullable	Description
conversationId	String	No	Conversation identifier.
name	String	Yes	Conversation name.
status	String	No	Conversation status.
startTime	String (ISO 8601)	No	Conversation start time.
endTime	String (ISO 8601)	Yes	Conversation end time.
conversationOwnerId	String	No	Owner identifier.
sessions	Array	No	List of sessions in this conversation.
sessions[].sessionId	String	No	Session identifier.
sessions[].status	String	No	Session status.
sessions[].startTime	String (ISO 8601)	No	Session start time.
sessions[].endTime	String (ISO 8601)	Yes	Session end time.
sessions[].entries	Array	No	List of entries in this session.
metadata	Object	Yes	Conversation metadata.
nextPageToken	String	Yes	Pagination token. Present if more results exist.

Entry Fields

Field	Type	Nullable	Description
id	String	No	Entry identifier.
interactionId	String	No	Groups related entries (for example, a turn).
participantId	String	No	Who generated this entry.
content	String	Yes	Message or event content.
type	String	Yes	Entry type.
timestamp	String (ISO 8601)	No	Timestamp of the entry.
category	String	No	Entry category. Values: `Message`, `Trace`, or `Entry`.
variable	Map	No	Free-form key-value variables.

Example Response

Status: 200 OK

1{
2  "conversationId": "conv-123",
3  "name": "Support chat — order #4471",
4  "status": "COMPLETED",
5  "startTime": "2026-06-18T14:22:00Z",
6  "endTime": "2026-06-18T14:58:00Z",
7  "conversationOwnerId": "indiv-001",
8  "sessions": [
9    {
10      "sessionId": "sess-A",
11      "status": "COMPLETED",
12      "startTime": "2026-06-18T14:22:00Z",
13      "endTime": "2026-06-18T14:35:00Z",
14      "entries": [
15        {
16          "id": "entry-1",
17          "interactionId": "turn-1",
18          "participantId": "user-001",
19          "content": "Where is my order?",
20          "type": "user_message",
21          "timestamp": "2026-06-18T14:22:05Z",
22          "category": "Message",
23          "variable": { "lang": "en" }
24        }
25      ]
26    }
27  ],
28  "metadata": { "channel": "web" },
29  "nextPageToken": "eyJvZmZzZXQiOjEwMH0="
30}

Error Codes

Status Code	Description
400	Bad Request. Invalid query parameters.
401	Unauthorized. Invalid or missing JWT token.
404	Not Found. Conversation does not exist.
500	Internal Server Error.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!