Get Conversation
curl --request GET \
--url https://api.attention.tech/v2/conversations/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.attention.tech/v2/conversations/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.attention.tech/v2/conversations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/conversations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/conversations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.attention.tech/v2/conversations/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/conversations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"type": "conversations",
"id": "conv-uuid-123",
"attributes": {
"uuid": "conv-uuid-123",
"title": "Q1 Deal Review - Acme Corp",
"createdAt": "2024-03-18T10:00:00Z",
"finishedAt": "2024-03-18T10:45:00Z",
"liveStreamStartedAt": "2024-03-18T10:00:00Z",
"liveStreamEndedAt": "2024-03-18T10:45:00Z",
"userUUID": "user-uuid-456",
"teamUUID": "team-uuid-789",
"archived": false,
"referenceable": true,
"private": false,
"isInternal": false,
"isEmpty": false,
"mediaDuration": 2700,
"videoUID": "vid-uid-abc",
"videoStatus": "ready",
"mediaStorageStatus": "ready",
"transcriptStatus": "completed",
"crmExportStatus": "exported",
"importStatus": "completed",
"dealUUID": "deal-uuid-xyz",
"emailTemplateID": "",
"externalIntelligenceOpportunityID": "opp-ext-123",
"zoomMeetingJoinUrl": "",
"googleMeetJoinUrl": "",
"microsoftTeamsJoinUrl": "",
"webexJoinUrl": "",
"transcript": {},
"participants": [
{
"id": "part-uuid-1",
"email": "jane@example.com",
"name": "Jane Smith",
"organizer": true,
"status": "accepted"
},
{
"id": "part-uuid-2",
"email": "john@customer.com",
"name": "John Doe",
"organizer": false,
"status": "accepted"
}
],
"attendees": [
{
"id": "part-uuid-1",
"email": "jane@example.com",
"name": "Jane Smith",
"organizer": true,
"status": "accepted"
}
],
"bots": [
{
"uuid": "bot-uuid-1",
"meetingUrl": "https://zoom.us/j/1234567890",
"status": {
"code": "completed",
"message": "Recording uploaded",
"createdAt": "2024-03-18T10:50:00Z"
}
}
],
"boards": [
{
"uuid": "cb-uuid-1",
"board": {
"uuid": "board-uuid-1",
"name": "Sales Playbook",
"teamUUID": "team-uuid-789",
"columns": []
},
"battlecards": []
}
],
"talktracks": [
{
"uuid": "ct-uuid-1",
"items": [
{
"uuid": "cti-uuid-1",
"activatedItemId": "item-uuid-1",
"done": true
}
]
}
],
"scorecardResults": [
{
"uuid": "sr-uuid-1",
"title": "Sales Discovery Scorecard",
"items": [],
"summary": {
"averageScore": 85,
"min": 0,
"max": 100,
"summaryText": "Good performance"
}
}
],
"externalOpportunity": {
"uuid": "opp-uuid-456",
"title": "Enterprise Deal - Acme Corp"
},
"importMetadata": {},
"linkedCrmRecords": [
{
"id": "001ABC123",
"code": "Account"
}
],
"externalAccounts": [
{
"id": "001ACC456",
"code": "Account"
}
],
"externalContacts": [
{
"id": "003CON789",
"code": "Contact"
}
],
"extractedIntelligence": {},
"confirmedExtractedIntelligence": {},
"labels": {},
"labelTagsToFilterIfNA": [],
"deprecatedLabelCategories": []
},
"links": {
"self": "/v2/conversations/conv-uuid-123"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Conversation
Get Conversation
Retrieves detailed information about a specific conversation, including its transcription, participants, and metadata. The response can be customized to include or exclude certain details based on the query parameters.
GET
/
conversations
/
{id}
Get Conversation
curl --request GET \
--url https://api.attention.tech/v2/conversations/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.attention.tech/v2/conversations/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.attention.tech/v2/conversations/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/conversations/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/conversations/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.attention.tech/v2/conversations/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/conversations/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"type": "conversations",
"id": "conv-uuid-123",
"attributes": {
"uuid": "conv-uuid-123",
"title": "Q1 Deal Review - Acme Corp",
"createdAt": "2024-03-18T10:00:00Z",
"finishedAt": "2024-03-18T10:45:00Z",
"liveStreamStartedAt": "2024-03-18T10:00:00Z",
"liveStreamEndedAt": "2024-03-18T10:45:00Z",
"userUUID": "user-uuid-456",
"teamUUID": "team-uuid-789",
"archived": false,
"referenceable": true,
"private": false,
"isInternal": false,
"isEmpty": false,
"mediaDuration": 2700,
"videoUID": "vid-uid-abc",
"videoStatus": "ready",
"mediaStorageStatus": "ready",
"transcriptStatus": "completed",
"crmExportStatus": "exported",
"importStatus": "completed",
"dealUUID": "deal-uuid-xyz",
"emailTemplateID": "",
"externalIntelligenceOpportunityID": "opp-ext-123",
"zoomMeetingJoinUrl": "",
"googleMeetJoinUrl": "",
"microsoftTeamsJoinUrl": "",
"webexJoinUrl": "",
"transcript": {},
"participants": [
{
"id": "part-uuid-1",
"email": "jane@example.com",
"name": "Jane Smith",
"organizer": true,
"status": "accepted"
},
{
"id": "part-uuid-2",
"email": "john@customer.com",
"name": "John Doe",
"organizer": false,
"status": "accepted"
}
],
"attendees": [
{
"id": "part-uuid-1",
"email": "jane@example.com",
"name": "Jane Smith",
"organizer": true,
"status": "accepted"
}
],
"bots": [
{
"uuid": "bot-uuid-1",
"meetingUrl": "https://zoom.us/j/1234567890",
"status": {
"code": "completed",
"message": "Recording uploaded",
"createdAt": "2024-03-18T10:50:00Z"
}
}
],
"boards": [
{
"uuid": "cb-uuid-1",
"board": {
"uuid": "board-uuid-1",
"name": "Sales Playbook",
"teamUUID": "team-uuid-789",
"columns": []
},
"battlecards": []
}
],
"talktracks": [
{
"uuid": "ct-uuid-1",
"items": [
{
"uuid": "cti-uuid-1",
"activatedItemId": "item-uuid-1",
"done": true
}
]
}
],
"scorecardResults": [
{
"uuid": "sr-uuid-1",
"title": "Sales Discovery Scorecard",
"items": [],
"summary": {
"averageScore": 85,
"min": 0,
"max": 100,
"summaryText": "Good performance"
}
}
],
"externalOpportunity": {
"uuid": "opp-uuid-456",
"title": "Enterprise Deal - Acme Corp"
},
"importMetadata": {},
"linkedCrmRecords": [
{
"id": "001ABC123",
"code": "Account"
}
],
"externalAccounts": [
{
"id": "001ACC456",
"code": "Account"
}
],
"externalContacts": [
{
"id": "003CON789",
"code": "Contact"
}
],
"extractedIntelligence": {},
"confirmedExtractedIntelligence": {},
"labels": {},
"labelTagsToFilterIfNA": [],
"deprecatedLabelCategories": []
},
"links": {
"self": "/v2/conversations/conv-uuid-123"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Authorizations
Path Parameters
Unique identifier of the conversation
Query Parameters
Specify how to lookup the conversation: 'id' for internal conversation ID (default), 'external_id' for external application ID from imports
Available options:
id, external_id Include internal participants in the response
Include Zoom-specific metadata in the response
Include import metadata in the response
Omit the transcript field from the response.
Include detailed transcript information in the response
Response
Successfully retrieved conversation details
Was this page helpful?