Retrieve Results

Get Punctuated Transcript

﻿//  Overview 
Leveraging the unique interactionIdentifier provided upon successfully ﻿declaring﻿ the audio interaction, this endpoint enables you to instantly retrieve a detailed sentence-by-sentence transcript with precise timings, confidence scores, and ﻿speaker labels﻿.
When this GET request successfully executes, an HTTP status will be returned to indicate the request was successful, along with a JSON response providing ﻿detailed transcription output﻿.
Sample API Response (Truncated)
{
    "sentenceSegments": [
        {
        "participant": "participantOne",
        "startTimeOffset": 1410,
        "endTimeOffset": 3210,
        "phrase": "Thank you for calling America phone service.",
        "score": 0.99137425
        },
        {
        "participant": "participantOne",
        "startTimeOffset": 3210,
        "endTimeOffset": 5570,
        "phrase": "This is Adam speaking, how may I be of service.",
        "score": 0.99325925
        },
        ...
    ],
    "redactionSegments": [
        {
        "startTimeOffset": 24650,
        "endTimeOffset": 27530,
        "result": "CVV",
        "score": 0
        },
        ...
    ]
}
{
    "sentenceSegments": [
        {
        "participant": "participantOne",
        "startTimeOffset": 1410,
        "endTimeOffset": 3210,
        "phrase": "Thank you for calling America phone service.",
        "score": 0.99137425
        },
        {
        "participant": "participantOne",
        "startTimeOffset": 3210,
        "endTimeOffset": 5570,
        "phrase": "This is Adam speaking, how may I be of service.",
        "score": 0.99325925
        },
        ...
    ],
    "redactionSegments": [
        {
        "startTimeOffset": 24650,
        "endTimeOffset": 27530,
        "result": "CVV",
        "score": 0
        },
        ...
    ]
}
﻿
If an error occurs when requesting to declare the interaction, a standard HTTP status will be retuned to indicate the request was unsuccessful, along with a JSON response containing additional details to assist in ﻿troubleshooting﻿. 
﻿
﻿//  Request Parameters & Code Examples
Get a transcript by its ID
GET
Request
Path Params
interactionIdentifier
required
String
interactionIdentifier (GUID) returned upon successfully declaring the interaction
Header Parameters
X-API-Token
required
String
Valid API key associated with your account for authentication and usage tracking
Accept-Encoding
optional
String
Recommended for bandwidth optimization, will be 'gzip, deflate, br'
Curl
Node.js
JS
Python
Ruby
C#
PHP
var client = new RestClient("https://api.elevateai.com/v1/interactions/{interctionIdentifier}/transcripts/punctuated");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("X-API-Token", "{Your API Token}");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Accept-Encoding", "gzip, deflate, br");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
var client = new RestClient("https://api.elevateai.com/v1/interactions/{interctionIdentifier}/transcripts/punctuated");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("X-API-Token", "{Your API Token}");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Accept-Encoding", "gzip, deflate, br");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Responses
200
204
401
404
{
  "StatusCode": HttpStatusCode
}
{
  "StatusCode": HttpStatusCode
}
﻿
﻿
﻿//  Response Schema
Schema
Element
Type
Description
sentenceSegments
array of objects
Ordered list of each sentence spoken, excluding redacted phrases
sentenceSegments/participant
string
﻿﻿Speaker﻿ associated with sentence, will be either "participantOne" or "participantTwo"
sentenceSegments/startTimeOffset
number
Start time of sentence (in milliseconds)
sentenceSegments/endTimeOffset
number
End time of sentence (in milliseconds)
sentenceSegments/phrase
string
Punctuated sentence, with any ﻿redacted segments﻿ represented by "# # # #"
sentenceSegments/score
float
Confidence score
redactionSegments
array of objects
List of details associated with each redacted segment
redactionSegments/startTimeOffset
number
Start time of redacted phrase (in milliseconds)
redactionSegments/endTimeOffset
number
End time of redacted phrase (in milliseconds)
redactionSegments/result
string
Reason for redaction, will be "CVV", "Credit Card", or "Social Security"
redactionSegments/score
float
Confidence score
﻿

Element	Type	Description
sentenceSegments	array of objects	Ordered list of each sentence spoken, excluding redacted phrases
sentenceSegments/participant	string	Speaker associated with sentence, will be either "participantOne" or "participantTwo"
sentenceSegments/startTimeOffset	number	Start time of sentence (in milliseconds)
sentenceSegments/endTimeOffset	number	End time of sentence (in milliseconds)
sentenceSegments/phrase	string	Punctuated sentence, with any redacted segments represented by "# # # #"
sentenceSegments/score	float	Confidence score
redactionSegments	array of objects	List of details associated with each redacted segment
redactionSegments/startTimeOffset	number	Start time of redacted phrase (in milliseconds)
redactionSegments/endTimeOffset	number	End time of redacted phrase (in milliseconds)
redactionSegments/result	string	Reason for redaction, will be "CVV", "Credit Card", or "Social Security"
redactionSegments/score	float	Confidence score

Get Phrase-by-Phrase Transcript

Get CX AI

Get Punctuated Transcript

﻿// Overview

﻿// Request Parameters & Code Examples

﻿// Response Schema

Schema

// Overview

// Request Parameters & Code Examples

// Response Schema