Retrieve a Call Transcript — GET /calls/{identifier}

This endpoint returns the full transcript of a call with AI-resolved speaker labels applied. Shilo identifies each segment of the conversation and maps it to either the agent or the contact by name, giving you a clean, readable record of who said what. Because speaker resolution depends on the AI analysis pipeline completing successfully, the transcript is not available until progress on the analysis endpoint reaches 100. Requesting the transcript before that point returns a 409 Conflict response.

This endpoint is not available for organizations connected to Follow Up Boss. Requests from Follow Up Boss-integrated accounts will receive a 403 Forbidden response regardless of analysis status.

Endpoint

GET https://api.shilo.ai/api/v1/calls/{identifier}/transcript

Path Parameter

string

required

Identifies the call whose transcript you want to retrieve. The same three formats accepted by GET /calls/{identifier} are supported here:

Format	Example
`{uuid}`	`ee6f2136-b94a-4438-9335-3acf5b2a0d31`
`call_event_id:{uuid}`	`call_event_id:ee6f2136-b94a-4438-9335-3acf5b2a0d31`
`external_recording_id:{string}`	`external_recording_id:rec-20300924-001`

Response

A successful request returns HTTP 200 with a transcript object containing speaker-labeled segments. The exact structure of the transcript JSON varies by AI model configuration, but each segment includes the speaker’s resolved name and the text they spoke.

Before requesting the transcript, poll GET /calls/{identifier}/analysis until the progress field equals 100. Requesting the transcript while analysis is still running will return a 409 Conflict error. Speaker resolution must be fully complete before transcripts are served.

Example Response

{
  "call_id": "ee6f2136-b94a-4438-9335-3acf5b2a0d31",
  "segments": [
    {
      "speaker": "Jordan Smith",
      "start_time": 0.0,
      "end_time": 5.4,
      "text": "Hi Alex, this is Jordan calling from Premier Realty. How are you doing today?"
    },
    {
      "speaker": "Alex Johnson",
      "start_time": 5.6,
      "end_time": 10.2,
      "text": "Hi Jordan, I'm doing well, thanks for calling."
    },
    {
      "speaker": "Jordan Smith",
      "start_time": 10.5,
      "end_time": 18.9,
      "text": "Great to hear it. I wanted to follow up on the properties you were looking at in the Eastside neighborhood. Did you get a chance to review the ones I sent over?"
    }
  ]
}

Example Request

curl --request GET \
  --url "https://api.shilo.ai/api/v1/calls/call_event_id:ee6f2136-b94a-4438-9335-3acf5b2a0d31/transcript" \
  --header "x-api-key: YOUR_API_KEY"

Error Responses

400 Bad Request — The identifier format is invalid or cannot be parsed.

{
  "statusCode": 400,
  "message": "Invalid identifier format"
}

403 Forbidden — Your organization’s CRM integration does not support transcript access. This error is returned for all Follow Up Boss-connected accounts.

{
  "statusCode": 403,
  "message": "Transcript access is not supported for this integration"
}

404 Not Found — No call matching the provided identifier exists in your organization.

{
  "statusCode": 404,
  "message": "Call not found"
}

409 Conflict — The transcript is not yet available because AI analysis and speaker resolution have not completed. Poll GET /calls/{identifier}/analysis until progress equals 100, then retry this request.

{
  "statusCode": 409,
  "message": "Transcript is not ready. Analysis must complete before the transcript can be served."
}

Overview

Calls

Appointments

Roleplays

Contacts

Users

Invitations

Metrics

Coaching

Retrieve a Call Transcript — GET /calls/{identifier}

Endpoint

Path Parameter

Response

Example Response

Example Request

Error Responses

​Endpoint

​Path Parameter

​Response

​Example Response

​Example Request

​Error Responses

Endpoint

Path Parameter

Response

Example Response

Example Request

Error Responses