---
schema_version: "1"
id: b0ff3b679ff3790bee8685b79bf00ed9d1660ed5fe3c313cb60343bb892d9579
title: Conversation Retrieval APIs
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-conversation-retrieval-apis.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-conversation-retrieval-apis.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 0cdda77c2c682b4621fd111cd9524369fe37b51220ca87dba2a02f071154b4cc
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# Conversation Retrieval APIs

Retrieve conversation data from Data 360's real-time hot layer. These read-only endpoints expose conversation Data Graphs stored in the hot layer, providing filtered access to conversation history, entries, and participant information.

**Base Path:** `/api/v1/agentic` (also aliased at `/personalization/v1/agentic`)

**Authentication:** Bearer JWT token

**Required Header:** `agent_id` — Agent identifier

**Available in:** All editions supported by Data 360. See [Data 360 edition availability].

> **Note:** These are read-only endpoints. All conversation writes must go through the [Conversation Ingest APIs].

## Pagination

All three read endpoints follow the same pagination pattern.

1. The first response may include `nextPageToken` if more results exist.
2. To retrieve the next page, replay the same request with the `page_token` query parameter set to the value of `nextPageToken`.
3. When `nextPageToken` is absent or empty, iteration is complete.

**Example:**

First request:

```
GET /api/v1/agentic/conversations?owner_id=003AB000000XYZ&owner_type=individual
```

Response includes: `"nextPageToken": "eyJvZmZzZXQiOjUwfQ=="`

Second request:

```
GET /api/v1/agentic/conversations?owner_id=003AB000000XYZ&owner_type=individual&page_token=eyJvZmZzZXQiOjUwfQ==
```

## Considerations

- **owner_type requirement:** Required on List Conversations and List Sessions endpoints. Optional on Get Conversation endpoint.
- **agent_id location:** `agent_id` is a required header, not a query parameter. All three endpoints reject requests without it.
- **scope parameter:** Only available on Get Conversation endpoint. Not supported on List Conversations or List Sessions.
- **Error model:** Read API errors return this format:

```json
{
  "timestamp": "2026-06-18T14:22:00Z",
  "error": "CDP_NOT_FOUND",
  "message": "Conversation not found",
  "path": "/server/api/v1/agentic/conversations/conv-999",
  "tenantId": "a360/prod/00D...",
  "internalErrorCode": "CONV_404",
  "details": {}
}
```