Get Transcription
Retrieve the full transcription with speaker diarization and emotion analysis.
GET
https://api.identitycall.com/api/v1/public/recordings/:id/transcriptionGet 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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | - | Recording ID |
Request
cURL
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
| Field | Type | Description |
|---|---|---|
recording_id | integer | Recording ID |
language | string | Detected/specified language |
full_text | string | Complete transcript as plain text |
dialogues | array | Individual speech segments |
Dialogue Object
| Field | Type | Description |
|---|---|---|
id | integer | Dialogue segment ID |
position | integer | Order in conversation (1-indexed) |
speaker | string | Speaker label (e.g., “Speaker 1”) |
voice_profile_id | integer | Matched voice profile ID (if identified) |
voice_profile_name | string | Matched voice profile name (if identified) |
text | string | Transcribed text for this segment |
start_ms | integer | Start time in milliseconds |
end_ms | integer | End time in milliseconds |
emotion | object | Emotion probabilities (0-1 for each) |
Emotion Fields
Each emotion field contains a probability between 0 and 1:
| Field | Description |
|---|---|
happy | Joy, happiness |
neutral | Neutral tone |
calm | Calm, relaxed |
sad | Sadness |
angry | Anger, frustration |
fearful | Fear, anxiety |
surprised | Surprise |
disgust | Disgust |
Errors
| Status | Error | Description |
|---|---|---|
| 404 | ”Resource not found” | Recording doesn’t exist |
| 422 | ”Transcription not available” | Recording not yet completed |