Sign in
Conversations

List conversations

Retrieve your conversation transcripts. Only returns completed, non-discarded conversations.

get/v1/dev/user/conversations

Query parameters

limitinteger

Maximum number of conversations to return.

offsetinteger

Number of conversations to skip.

start_datestring date-time

Filter by start date (inclusive). ISO 8601 format.

end_datestring date-time

Filter by end date (inclusive). ISO 8601 format.

include_transcriptboolean

Include full transcript segments in the response.

categoriesstring

Comma-separated list of conversation categories to filter by (e.g. work,personal). Matches conversations whose category is any of the listed values (OR semantics).

folder_idstring

Filter conversations by folder ID. Each conversation belongs to at most one folder, so this is a single-value filter. Must be a non-empty string.

starredboolean

Filter by starred status. Pass true for starred conversations only, false for non-starred.

Response

List of conversations.

idstring

Unique identifier.

created_atstring date-time

When the conversation record was created.

started_atstring date-time

When the conversation started.

finished_atstring date-time

When the conversation ended.

languagestring

Language code (e.g. en).

sourcestring

Source device or app.

folder_idstring nullable

ID of the folder this conversation belongs to, or null if not in any folder.

folder_namestring nullable

Display name of the folder, or null if not in any folder.

Changes