---
schema_version: "1"
id: b300f69c0bdf8f4ef4a6f3df8d4e984ff0eb1d73b91acfbb3c43a909413f47ee
title: List Conversations
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-list-conversations.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-list-conversations.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 06fbdecc573a0f39fccbd26f7a3d1b5ec5376b5eb6dfe41d7a9d66e7e3af2479
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# List Conversations

Returns a filtered, lightweight index of conversations owned by a given user. Returns only conversation-level summary rows, not the full data graph.

**URI:** `/api/v1/agentic/conversations`

**HTTP Method:** `GET`

**Authentication:** Bearer JWT

## Query Parameters

| Parameter      | Required | Description                                                                     |
| -------------- | -------- | ------------------------------------------------------------------------------- |
| owner_id       | Yes      | End-user's Individual ID.                                                       |
| owner_type     | Yes      | Owner type (for example, `individual`).                                         |
| status         | No       | Filter by conversation status.                                                  |
| time_range     | No       | Filter by time range.                                                           |
| fields         | No       | Projection list. Repeat parameter for multiple fields: `fields=id&fields=name`. |
| participant_id | No       | Filter by participant ID.                                                       |
| 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              | Description                                      |
| ---------------------------- | ----------------- | ------------------------------------------------ |
| conversations                | Array             | List of conversation summary items.              |
| conversations[].id           | String            | Conversation identifier.                         |
| conversations[].startTime    | String (ISO 8601) | Conversation start time.                         |
| conversations[].status       | String            | Conversation status.                             |
| conversations[].name         | String            | Conversation name.                               |
| conversations[].modifiedDate | String (ISO 8601) | Last modified date.                              |
| nextPageToken                | String            | Pagination token. Present if more results exist. |

### Example Response

**Status:** `200 OK`

```json
{
  "conversations": [
    {
      "id": "conv-123",
      "startTime": "2026-06-18T14:22:00Z",
      "status": "ACTIVE",
      "name": "Support chat — order #4471",
      "modifiedDate": "2026-06-18T14:55:00Z"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
}
```

## Error Codes

| Status Code | Description                                 |
| ----------- | ------------------------------------------- |
| 400         | Bad Request. Invalid query parameters.      |
| 401         | Unauthorized. Invalid or missing JWT token. |
| 500         | Internal Server Error.                      |