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

Returns a filtered, lightweight index of sessions for a given conversation.

**URI:** `/api/v1/agentic/conversations/{conversationId}/sessions`

**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. |
| owner_type | Yes | Owner type (for example, `individual`). |
| status | No | Filter by session status. |
| time_range | No | Filter by time range. |
| fields | No | Projection list. Repeat parameter for multiple fields. |
| 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 |
|-------|------|-------------|
| conversationId | String | Parent conversation identifier. |
| sessions | Array | List of session summary items. |
| sessions[].id | String | Session identifier. |
| sessions[].startTime | String (ISO 8601) | Session start time. |
| sessions[].status | String | Session status. |
| nextPageToken | String | Pagination token. Present if more results exist. |

### Example Response

**Status:** `200 OK`

```json
{
  "conversationId": "conv-123",
  "sessions": [
    { "id": "sess-A", "startTime": "2026-06-18T14:22:00Z", "status": "COMPLETED" },
    { "id": "sess-B", "startTime": "2026-06-18T14:40:00Z", "status": "ACTIVE" }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
}
```

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