> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get corrected transcripts
> Get the corrected transcript from your call's recording.
### Headers
Your API key for authentication.
### Path Parameters
The unique identifier for the call to be corrected.
### Response
Will be `success` if the request was successful.
Confirms the request was successful, or provides an error message if the request failed.
This will contain an array of objects with enhanced speaker information and confidence scores. Each object will be constructed as the following.
```json theme={null}
{
"start": 0.069, // start time of the transcript
"end": 2.551, // end time of the transcript
"text": " Hi, I'm calling about a pizza order.", // the corrected text
"speaker": 2, // the identified speaker diarization. Can be 1,2,3 etc
"speaker_label": "assistant", // human-readable speaker label ("user", "assistant")
"confidence": 0.762 // transcription confidence score (0-1)
}
```
**⚠️ DEPRECATED**: The `aligned` field is deprecated and will be removed in a future version. Please use the enhanced `corrected` field instead, which now includes `speaker_label` and `confidence` information.
Legacy description: This field provides a version of an 'aligned' transcript where the roles are matched to the pieces of text by vectorizing the text, taking the cosine similarity, and adding a predictive layer based off of the `wait_for_greeting` param.
This will contain an array of objects. Each object will be constructed as the following.
```json theme={null}
{
"id": 3056004,
"created_at": "2024-02-29T18:40:41.26799+00:00",
"text": "Great, Thanks John. Could you tell me about the pizza order you placed?", // the corrected text
"user": "assistant", // the presumed role
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
```
```json theme={null}
{
"corrected": [
{
"start": 0.069,
"end": 2.551,
"text": " Hi, I'm calling about a pizza order.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.762
},
{
"start": 2.551,
"end": 4.932,
"text": "Could I get your name, please?",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.843
},
{
"start": 4.932,
"end": 8.074,
"text": "Yeah, my name is John.",
"speaker": 1,
"speaker_label": "user",
"confidence": 0.654
},
{
"start": 8.074,
"end": 8.875,
"text": "Great.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.892
},
{
"start": 8.875,
"end": 9.876,
"text": "Thanks, John.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.765
},
{
"start": 9.876,
"end": 13.038,
"text": "Could you tell me about the pizza order you placed?",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.934
},
{
"start": 13.038,
"end": 16.36,
"text": "Yeah, I want a pepperoni.",
"speaker": 1,
"speaker_label": "user",
"confidence": 0.567
},
{
"start": 16.36,
"end": 17.1,
"text": "Oh, okay.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.456
},
{
"start": 17.1,
"end": 18.521,
"text": "One pepperoni pizza.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.789
},
{
"start": 18.521,
"end": 19.682,
"text": "Anything else with that order?",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.823
},
{
"start": 19.682,
"end": 23.665,
"text": "No, actually, can we cancel it?",
"speaker": 1,
"speaker_label": "user",
"confidence": 0.612
},
{
"start": 23.665,
"end": 26.306,
"text": "I gotta go.",
"speaker": 1,
"speaker_label": "user",
"confidence": 0.543
},
{
"start": 26.306,
"end": 27.427,
"text": "No problem.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.734
},
{
"start": 27.427,
"end": 28.668,
"text": "I'll cancel the order for you.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.856
},
{
"start": 29.144,
"end": 30.587,
"text": " Thanks for letting me know.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.678
},
{
"start": 30.587,
"end": 31.189,
"text": "Have a good one.",
"speaker": 2,
"speaker_label": "assistant",
"confidence": 0.812
}
],
"status": "success",
"aligned": [
{
"start": 0.069,
"end": 2.551,
"text": " Hi, I'm calling about a pizza order.",
"speaker": "assistant",
"similarity": 0.686406472983644
},
{
"start": 2.551,
"end": 4.932,
"text": "Could I get your name, please?",
"speaker": "assistant",
"similarity": 0.6793662204867575
},
{
"start": 4.932,
"end": 8.074,
"text": "Yeah, my name is John.",
"speaker": "user",
"similarity": 0.9999999999999998
},
{
"start": 8.074,
"end": 8.875,
"text": "Great.",
"speaker": "assistant",
"similarity": 0.2581988897471611
},
{
"start": 8.875,
"end": 9.876,
"text": "Thanks, John.",
"speaker": "assistant",
"similarity": 0.36514837167011066
},
{
"start": 9.876,
"end": 13.038,
"text": "Could you tell me about the pizza order you placed?",
"speaker": "assistant",
"similarity": 0.894427190999916
},
{
"start": 13.038,
"end": 16.36,
"text": "Yeah, I want a pepperoni.",
"speaker": "user",
"similarity": 0.7999999999999998
},
{
"start": 16.36,
"end": 17.1,
"text": "Oh, okay.",
"speaker": "user",
"similarity": 0.4999999999999999
},
{
"start": 17.1,
"end": 18.521,
"text": "One pepperoni pizza.",
"speaker": "assistant",
"similarity": 0.5773502691896257
},
{
"start": 18.521,
"end": 19.682,
"text": "Anything else with that order?",
"speaker": "assistant",
"similarity": 0.7453559924999299
},
{
"start": 19.682,
"end": 23.665,
"text": "No, actually, can we cancel it?",
"speaker": "user",
"similarity": 0.8164965809277261
},
{
"start": 23.665,
"end": 26.306,
"text": "I gotta go.",
"speaker": "user",
"similarity": 0.5773502691896257
},
{
"start": 26.306,
"end": 27.427,
"text": "No problem.",
"speaker": "assistant",
"similarity": 0.32444284226152503
},
{
"start": 27.427,
"end": 28.668,
"text": "I'll cancel the order for you.",
"speaker": "assistant",
"similarity": 0.5202659817144719
},
{
"start": 29.144,
"end": 30.587,
"text": " Thanks for letting me know.",
"speaker": "assistant",
"similarity": 0.6155870112510924
},
{
"start": 30.587,
"end": 31.189,
"text": "Have a good one.",
"speaker": "agent-action",
"similarity": 0.5
}
],
"original": [
{
"id": 3056032,
"created_at": "2024-02-29T18:40:49.592012+00:00",
"text": "Okay, One pepperoni pizza. Anything else with that order?",
"user": "assistant",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056054,
"created_at": "2024-02-29T18:40:59.641211+00:00",
"text": "No problem, Ill cancel the order for you. Thanks for letting me know, Have a good one!",
"user": "assistant",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3055999,
"created_at": "2024-02-29T18:40:40.39336+00:00",
"text": "Yeah. My name is John. ",
"user": "user",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056064,
"created_at": "2024-02-29T18:41:08.152963+00:00",
"text": "Okay. Bye. ",
"user": "user",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3055975,
"created_at": "2024-02-29T18:40:33.362607+00:00",
"text": "Hi, Im calling about a pizza order. Could I get your name please?",
"user": "assistant",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056028,
"created_at": "2024-02-29T18:40:48.597915+00:00",
"text": "Yeah. I want the pepperoni. ",
"user": "user",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056066,
"created_at": "2024-02-29T18:41:09.563502+00:00",
"text": "Ended call: Thanks, you too! Have a good day.",
"user": "agent-action",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056004,
"created_at": "2024-02-29T18:40:41.26799+00:00",
"text": "Great, Thanks John. Could you tell me about the pizza order you placed?",
"user": "assistant",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
},
{
"id": 3056053,
"created_at": "2024-02-29T18:40:58.62518+00:00",
"text": "No. Actually, can we cancel it? I gotta go. ",
"user": "user",
"c_id": "bfaf99a1-b7c0-4f96-9630-90bc41cea488"
}
]
}
```
***
Docs for agents: [llms.txt](/llms.txt)