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

1{
2  "conversations": [
3    {
4      "id": "conv-123",
5      "startTime": "2026-06-18T14:22:00Z",
6      "status": "ACTIVE",
7      "name": "Support chat — order #4471",
8      "modifiedDate": "2026-06-18T14:55:00Z"
9    }
10  ],
11  "nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
12}

Error Codes

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

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