Use to distill important messages and create a succinct summary for a conversation. You can create a Summary using the Get summary request.

Summaries save time by analyzing the contents of a conversation that might have several pages of transcripts.

Note that real-time summaries are not currently supported using the Streaming API. However, you can make a Get summary request during the conversation to fetch summaries progressively during the course of the conversation.

The following sample shows a multi-line transcript and corresponding summary:

Recorded Transcript Summary Created by Summary API

Sunita: You're breaking up a lot.

Liam: Yeah, I know at least hopefully you guys can see the transcription that's going on with what I am saying.

Liam: But yeah, we totally need to shift our focus more into our Dev, you know, in the field of Advocates who can really help us grow within their own circles.

Sunita: Yeah.

Liam: So I will go ahead and I will set up a discussion with the product.

Liam: And the dev team.

Sunita: Okay, that works.

Sunita: Perfect.

Sunita: What else Anh I know you had a couple of other things on the agenda, so we can totally talk about that right now.

Anh: Okay.

Anh: Yeah, so the only other thing was as we're talking about employee growth I wanted to basically touch base with you and understand how we can or in which geographies we need to focus on the sales hires first because what and what would be the most important would it be industry or would it be unreasonable understanding because for example in a region like Europe there is there are multiple languages and Regional influences.

Anh: No influences, so should we focus on that or focus more on the industry and grow that way, so they're both strategies?

Sunita, Liam, and Anh need to focus more on the Dev team and on the product. In order to focus on the sales hire, Anh needs to know which geographies they should focus on.


This request requires an access token, as described in Authenticate.

Get summary

This section describes how to get a conversation summary. This request requires a conversation ID. You receive a conversation ID when you process a conversation with the APIs.

To get a summary, use the GET <><CONVERSATION_ID>/summary operation:


Try our interactive examples!

We provide interactive versions of these code samples: curl, Node.js, Python

To get started with our code samples, see Set Up Your Test Environment.


curl --request GET \
  --url "$CONVERSATION_ID/summary" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json"
import fetch from 'node-fetch';

const accessToken = '<ACCESS_TOKEN>';
const conversationId = '<CONVERSATION_ID>';

const fetchResponse = await fetch(`${conversationId}/summary`, {
  method: 'get',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'

const responseBody = await fetchResponse.json();

console.log(JSON.stringify(responseBody, null, 2));
import json
import requests

access_token = "<ACCESS_TOKEN>"
conversation_id = "<CONVERSATION_ID>"

headers = {
  "Authorization": "Bearer " + access_token,
  "Content-Type": "application/json"

response = requests.request(
  url="" + conversation_id + "/summary",

print(json.dumps(response.json(), indent=2))


For additional reference information, see Get Summary by conversation ID.

Example response

  "summary": [
      "id": "5255215497347072",
      "text": "Speaker installed slow internet service for their new home Speaker will send an internet service technician to Speaker's home at 5 pm they will call back in an hour to confirm the appointment.",
      "messageRefs": [
          "id": "4808748496322560"
          "id": "5939064753618944"
          "id": "6418613790572544"
          "id": "6633702162432000"
          "id": "4593008581279744"
          "id": "6226587111391232"
          "id": "6376853488009216"
          "id": "4550301271982080"
          "id": "5439006408966144"
          "id": "5588718130823168"
          "id": "5447911688110080"
      "startTime": "2022-08-23T00:27:43.784Z",
      "endTime": "2022-08-23T01:14:55.304Z",

Response fields

idThe identifier of this summary within the scope of the conversation.
textThe text of the summary.
messageRefs.idThe identifier of each message that makes up the summary.
startTimeThe timestamp indicating when the conversation started.
endTimeThe timestamp indicating when the conversation ended.