---
schema_version: "1"
id: a75c0d9b4d34a194cf8e5e66eee528c080d679ab5ab4cf371b14970c15c5ca7d
title: Get Conversation Data Graph
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-get-conversation-data-graph.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-get-conversation-data-graph.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 2a325004df8f9a0176f4f5b81725f4b0ee3f00f48edc680c54adecac7377f4b6
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# 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.                                   |
| 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`

```json
{
  "conversationId": "conv-123",
  "name": "Support chat — order #4471",
  "status": "COMPLETED",
  "startTime": "2026-06-18T14:22:00Z",
  "endTime": "2026-06-18T14:58:00Z",
  "conversationOwnerId": "indiv-001",
  "sessions": [
    {
      "sessionId": "sess-A",
      "status": "COMPLETED",
      "startTime": "2026-06-18T14:22:00Z",
      "endTime": "2026-06-18T14:35:00Z",
      "entries": [
        {
          "id": "entry-1",
          "interactionId": "turn-1",
          "participantId": "user-001",
          "content": "Where is my order?",
          "type": "user_message",
          "timestamp": "2026-06-18T14:22:05Z",
          "category": "Message",
          "variable": { "lang": "en" }
        }
      ]
    }
  ],
  "metadata": { "channel": "web" },
  "nextPageToken": "eyJvZmZzZXQiOjEwMH0="
}
```

## 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.                      |