ConversationsExport
One processed conversation, including linked CRM data, customer, coaching results and temporary download URLs. Also returned directly by GET /export/conversations/{conversationId}.
Fields
Required means the key is present; nullable means its value may be null. These are different. Examples are synthetic, complete for the documented fields, and not real customer data.
ID of the underlying recording.
"22222222-2222-4222-8222-222222222222"Recording start timestamp in ISO 8601 UTC. List selection uses inclusive date bounds.
"2026-09-01T14:00:00Z"Date/time the conversation finished processing (ISO 8601).
"2026-09-01T15:12:00Z"Title of the conversation / appointment.
"Home estimate - Jordan Lee"ID of the associated CRM / calendar event.
"evt-90817"The rep who recorded the conversation: { id, name, email }.
Temporary presigned S3 URL for the conversation's transcript. Expires 6 hours after the response is issued — download or persist the file rather than storing the URL. Temporary signing credentials may cause earlier expiry.
"https://example.com/temporary-transcript.json?signature=EXAMPLE"ServiceTitan job link when the linked appointment uses that integration; null otherwise. Not a generic CRM URL.
"https://go.servicetitan.com/jobs/4471"Price on the linked appointment in its source currency, or null. This field alone does not establish a sold outcome; no currency code is returned.
12500AI-generated summary of the job.
"Rep walked the customer through the premium package and scheduled install."Admin summary / custom insights in your organization's format.
"Customer expressed interest in premium package..."Longest uninterrupted rep monologue, in seconds.
120Longest uninterrupted customer monologue, in seconds.
64All-time comments on this conversation, not bounded by the request window.
3Link to view the conversation in the Rilla web app.
"https://app.rilla.com/conversations/single?id=11111111-1111-4111-8111-111111111111"Temporary presigned S3 URL for the conversation's audio recording. Expires 6 hours after the response is issued — download or persist the file rather than storing the URL. Temporary signing credentials may cause earlier expiry.
"https://example.com/temporary-audio.mp3?signature=EXAMPLE"Coaching checklists scored for the conversation. Each checklist contains its trackers. See Checklist.
Trackers outside the checklist, from the latest completed evaluations. Not a flattened copy of checklists.trackerData.
Custom fields from the calendar event. Keys and values are customer-defined. null if none are set.
{"leadSource":"Website"}Linked customer contact and structured address; null when no customer fields exist.
Survey results. Each result includes a survey ID, name and customer-defined data; the upstream service may include additional metadata.
Complete example
{
"conversationId": "11111111-1111-4111-8111-111111111111",
"recordingId": "22222222-2222-4222-8222-222222222222",
"date": "2026-09-01T14:00:00Z",
"processedDate": "2026-09-01T15:12:00Z",
"title": "Home estimate - Jordan Lee",
"duration": 3240,
"crmEventID": "evt-90817",
"user": {
"id": "33333333-3333-4333-8333-333333333333",
"name": "Alex Morgan",
"email": "alex@example.com"
},
"transcriptUrl": "https://example.com/temporary-transcript.json?signature=EXAMPLE",
"jobNumber": "JOB-4471",
"stLink": "https://go.servicetitan.com/jobs/4471",
"totalSold": 12500,
"outcome": "Sold",
"jobSummary": "Rep walked the customer through the premium package and scheduled install.",
"customSummary": "Customer expressed interest in premium package...",
"repSpeedWPM": 148,
"repTalkRatio": 0.54,
"longestRepMonologue": 120,
"longestCustomerMonologue": 64,
"totalComments": 3,
"rillaUrl": "https://app.rilla.com/conversations/single?id=11111111-1111-4111-8111-111111111111",
"audioUrl": "https://example.com/temporary-audio.mp3?signature=EXAMPLE",
"viewers": [
{
"userId": "user-014",
"name": "Manager Mike",
"viewCount": 2,
"totalViewTimeMs": 540000
}
],
"checklists": [
{
"name": "Discovery",
"checklistName": "Discovery",
"score": 1,
"checklistScore": 1,
"denominator": 1,
"checklistDenominator": 1,
"trackerData": [
{
"trackerId": "1042",
"name": "Asked about budget",
"trackerName": "Asked about budget",
"isHit": true,
"trackerIsHit": true,
"aiScore": 0.92,
"trackerAiScore": 0.92
}
]
}
],
"aiTrackers": [
{
"checklistName": "Discovery",
"trackerId": "1043",
"trackerName": "Mentioned financing",
"isHit": true,
"aiScore": 0.92
}
],
"customFields": {
"leadSource": "Website"
},
"customer": {
"name": "Jordan Lee",
"email": "jordan@example.com",
"phone": "+1-202-555-0142",
"address": {
"street": "123 Example Street",
"unit": null,
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US"
}
},
"surveyResults": [
{
"surveyId": "55555555-5555-4555-8555-555555555555",
"surveyName": "Discovery quality",
"data": {
"next_step_confirmed": true
}
}
]
}