Retrieve a conversation

View as Markdown
Return one stored record in data by its identifier. This operation does not accept a date range. Full stored analysis and transcription are returned without an include selector. The record follows the existing analytics webhook format: audio_to_text.transcript for calls or chat_transcription.transcript for chats, meta_analytics and native conversation_analytics modules. Customer analytics and customer timeline are excluded. For larger datasets, use [Create export](/v0/api-reference/exports/create-export) to obtain a CSV download link. Each export supports at most 31 days, 100,000 records and 100 MB; split longer periods into adjacent windows.

Authentication

AuthorizationBearer
Existing private account API key from Developer Hub. Keep it on your backend.

Path parameters

conversation_idstringRequired1-255 characters

Identifier returned by the corresponding list operation. Nonempty, at most 255 characters; whitespace-only values and control characters are rejected.

Query parameters

service_idstringRequired1-255 characters

Required authorized service. Client identity is derived from the API key. Nonempty, at most 255 characters; whitespace-only values and control characters are rejected.

Response

Successful response.
dataobject

Native analytics webhook payload, excluding customer_analytics, timeline, usage, client_system_parameters, processing_id and ledger_entry. Configured modules and missing values are preserved as stored.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error