Skip to Content
API ReferenceRecordingsGet Transcription

Get Transcription

Retrieve the full transcription with speaker diarization and emotion analysis.

GEThttps://api.identitycall.com/api/v1/public/recordings/:id/transcription

Get the complete transcription with individual dialogue segments.

Requires read permission

The transcription is only available after the recording status is completed. Check the status using the Get Recording endpoint first.

Path Parameters

Parameters

NameTypeRequiredDefaultDescription
idintegerYes-Recording ID

Request

curl -X GET "https://api.identitycall.com/api/v1/public/recordings/123/transcription" \ -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Response

Response200 OK
{
"data": {
  "recording_id": 123,
  "language": "en",
  "full_text": "Hello, thank you for calling IdentityCall support. How can I help you today? Hi, I'm having trouble logging into my account. I'd be happy to help you with that. Can you tell me the email address associated with your account?",
  "dialogues": [
    {
      "id": 456,
      "position": 1,
      "speaker": "Speaker 1",
      "voice_profile_id": null,
      "voice_profile_name": null,
      "text": "Hello, thank you for calling IdentityCall support. How can I help you today?",
      "start_ms": 0,
      "end_ms": 4500,
      "emotion": {
        "happy": 0.7,
        "neutral": 0.2,
        "calm": 0.1,
        "sad": 0.0,
        "angry": 0.0,
        "fearful": 0.0,
        "surprised": 0.0,
        "disgust": 0.0
      }
    },
    {
      "id": 457,
      "position": 2,
      "speaker": "Speaker 2",
      "voice_profile_id": 89,
      "voice_profile_name": "John Smith",
      "text": "Hi, I'm having trouble logging into my account.",
      "start_ms": 5000,
      "end_ms": 8200,
      "emotion": {
        "happy": 0.0,
        "neutral": 0.6,
        "calm": 0.1,
        "sad": 0.2,
        "angry": 0.1,
        "fearful": 0.0,
        "surprised": 0.0,
        "disgust": 0.0
      }
    },
    {
      "id": 458,
      "position": 3,
      "speaker": "Speaker 1",
      "voice_profile_id": null,
      "voice_profile_name": null,
      "text": "I'd be happy to help you with that. Can you tell me the email address associated with your account?",
      "start_ms": 8800,
      "end_ms": 13500,
      "emotion": {
        "happy": 0.5,
        "neutral": 0.3,
        "calm": 0.2,
        "sad": 0.0,
        "angry": 0.0,
        "fearful": 0.0,
        "surprised": 0.0,
        "disgust": 0.0
      }
    }
  ]
}
}

Response Fields

Top Level

FieldTypeDescription
recording_idintegerRecording ID
languagestringDetected/specified language
full_textstringComplete transcript as plain text
dialoguesarrayIndividual speech segments

Dialogue Object

FieldTypeDescription
idintegerDialogue segment ID
positionintegerOrder in conversation (1-indexed)
speakerstringSpeaker label (e.g., “Speaker 1”)
voice_profile_idintegerMatched voice profile ID (if identified)
voice_profile_namestringMatched voice profile name (if identified)
textstringTranscribed text for this segment
start_msintegerStart time in milliseconds
end_msintegerEnd time in milliseconds
emotionobjectEmotion probabilities (0-1 for each)

Emotion Fields

Each emotion field contains a probability between 0 and 1:

FieldDescription
happyJoy, happiness
neutralNeutral tone
calmCalm, relaxed
sadSadness
angryAnger, frustration
fearfulFear, anxiety
surprisedSurprise
disgustDisgust

Errors

StatusErrorDescription
404”Resource not found”Recording doesn’t exist
422”Transcription not available”Recording not yet completed

Try It

Try It