Get a conversation

Retrieve a conversation by its Rilla conversation ID.

GET/export/conversations/{conversationId}

Authentication

Authorization: YOUR_API_KEY

No Bearer prefix.

Base URL: https://customer.rillavoice.com

Path parameters

conversationIdstring · uuidrequired

The Rilla conversation ID, not the recording ID or the CRM event ID.

Returns a bare conversation object, not a pagination envelope. An unknown or out-of-scope conversation returns 404.

Responses

200Returns ConversationsExport

A bare ConversationsExport object. No envelope.

401Missing or invalid API key.

400Invalid request parameters.

404Record not found or outside your key’s scope.

Error reference

Common problems

400 · "Request body failed validation"

The message is the same for invalid query and path parameters. Read errors[].path and errors[].message. Send every parameter in the query string, URL-encoded; these GET requests take no body. conversationId must be a valid UUID.

401 · Missing or invalid key

Use Authorization: YOUR_API_KEY, without Bearer, and the customer.rillavoice.com host. Use the key value, not its ID.

404 · Conversation not found

Use the conversation ID, not recordingId or crmEventID. Check that the conversation belongs to the organization and scope of your API key.

Request example

curl --request GET \
  --url 'https://customer.rillavoice.com/export/conversations/11111111-1111-4111-8111-111111111111' \
  --header 'Authorization: YOUR_API_KEY'

Complete response example · application/json · ConversationsExport ↗

View complete JSON response

{
  "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": 1,
      "totalViewTimeMs": 270000,
      "views": [
        {
          "viewId": "66666666-6666-4666-8666-666666666666",
          "viewedAt": "2026-09-02T14:30:00.000Z",
          "durationMs": 270000
        }
      ]
    }
  ],
  "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
      }
    }
  ],
  "comments": [
    {
      "commentId": "77777777-7777-4777-8777-777777777777",
      "parentId": null,
      "userId": "user-014",
      "userName": "Manager Mike",
      "content": "@Rep Rachel great discovery questions here",
      "createdAt": "2026-09-02T14:30:00.000Z",
      "attachment": {
        "type": "AUDIO",
        "mimeType": "audio/mp4",
        "transcript": "Slow down when you get to price.",
        "downloadUrl": "https://example.com/temporary-comment.m4a?signature=EXAMPLE"
      },
      "startTime": 12.5,
      "endTime": 20.25
    }
  ]
}

← List conversations Get a transcript