Sign in

v3

latestOpenAPI 3.1.02026-08-0755220214.3 KB
conversations

List

Returns conversations with optional filtering.

get/conversations

Query parameters

projectstring

The name of the project to list conversations for.

external_idstring

Filter by external ID to get a specific conversation.

duration_mininteger

Minimum duration in seconds.

duration_maxinteger

Maximum duration in seconds.

started_at_minstring

Minimum start date/time. Valid examples: 2025-04-17, 2025-04-17T02:48:52.708Z

started_at_maxstring

Maximum start date/time. Valid examples: 2025-04-17, 2025-04-17T02:48:52.708Z

beforestring

Cursor for backward pagination. Use a conversation ID from pagination.prev_cursor to fetch the previous page of conversations. Cannot be used with after.

afterstring

Cursor for forward pagination. Use a conversation ID from pagination.next_cursor to fetch the next page of conversations. Cannot be used with before.

limitinteger

Maximum number of conversations to return per page.

audio_container'wav.gz' | 'wav'

Format of the presigned audio_url in each conversation in the response.

Headers

Authorizationstring required

Bearer authentication header of the form Bearer <PHONIC_API_KEY>. Manage your API keys here.

Response

Paginated list (conversations, pagination) when listing, or a single conversation when the external_id query parameter matches exactly one conversation.

OR