Get Results

Retrieve goal achievements, keyword detections, and pause analysis.

GEThttps://api.identitycall.com/api/v1/public/recordings/:id/results

Get AI-powered analysis including goal evaluation, keyword detection, and pause analysis.

Requires read permission

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/results" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Python


import requests
import os
 
API_KEY = os.environ.get("IDENTITYCALL_API_KEY")
recording_id = 123
 
response = requests.get(
    f"https://api.identitycall.com/api/v1/public/recordings/{recording_id}/results",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
 
results = response.json()["data"]
 
print("Goals:")
for goal in results["goals"]:
    status = "✓" if goal["met"] else "✗"
    print(f"  {status} {goal['goal_name']} (score: {goal['score']:.2f})")
    print(f"    {goal['explanation']}")
 
print("\nKeywords:")
for keyword in results["keywords"]:
    print(f"  - {keyword['keyword_name']}: {keyword['count']} occurrences")
 
print("\nPauses:")
for pause in results["pauses"]:
    duration_sec = pause["duration_ms"] / 1000
    compliance = "compliant" if pause["compliant"] else "non-compliant"
    print(f"  - {duration_sec:.1f}s pause at {pause['start_ms']}ms ({compliance})")

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
const recordingId = 123;
 
const response = await fetch(
  `https://api.identitycall.com/api/v1/public/recordings/${recordingId}/results`,
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
 
const { data: results } = await response.json();
 
console.log('Goals:');
results.goals.forEach(goal => {
  const status = goal.met ? '✓' : '✗';
  console.log(`  ${status} ${goal.goal_name} (score: ${goal.score.toFixed(2)})`);
  console.log(`    ${goal.explanation}`);
});
 
console.log('\nKeywords:');
results.keywords.forEach(keyword => {
  console.log(`  - ${keyword.keyword_name}: ${keyword.count} occurrences`);
});

PHP


<?php
$apiKey = getenv('IDENTITYCALL_API_KEY');
$recordingId = 123;
 
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.identitycall.com/api/v1/public/recordings/$recordingId/results",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"]
]);
 
$response = curl_exec($ch);
$results = json_decode($response, true)['data'];
 
echo "Goals:\n";
foreach ($results['goals'] as $goal) {
    $status = $goal['met'] ? '✓' : '✗';
    echo "  $status {$goal['goal_name']} (score: {$goal['score']})\n";
}

Ruby


require 'net/http'
require 'json'
 
API_KEY = ENV['IDENTITYCALL_API_KEY']
recording_id = 123
 
uri = URI("https://api.identitycall.com/api/v1/public/recordings/#{recording_id}/results")
request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Bearer #{API_KEY}"
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
 
results = JSON.parse(response.body)['data']
 
puts "Goals:"
results['goals'].each do |goal|
  status = goal['met'] ? '✓' : '✗'
  puts "  #{status} #{goal['goal_name']} (score: #{goal['score']})"
end

Response

Response200 OK

{
"data": {
  "recording_id": 123,
  "goals": [
    {
      "goal_id": 1,
      "goal_name": "Greeting and Introduction",
      "met": true,
      "score": 0.95,
      "explanation": "Agent properly greeted the customer and introduced themselves within the first 10 seconds."
    },
    {
      "goal_id": 2,
      "goal_name": "Collect Email Address",
      "met": true,
      "score": 0.88,
      "explanation": "Agent successfully collected and verified the customer's email address."
    },
    {
      "goal_id": 3,
      "goal_name": "Offer Follow-up",
      "met": false,
      "score": 0.30,
      "explanation": "Agent did not offer a follow-up call or email to confirm resolution."
    }
  ],
  "keywords": [
    {
      "keyword_id": 1,
      "keyword_name": "thank you",
      "sentiment": "positive",
      "count": 3,
      "timestamps_ms": [4200, 45000, 178000]
    },
    {
      "keyword_id": 2,
      "keyword_name": "password reset",
      "sentiment": "neutral",
      "count": 2,
      "timestamps_ms": [12500, 89000]
    },
    {
      "keyword_id": 3,
      "keyword_name": "frustrated",
      "sentiment": "negative",
      "count": 1,
      "timestamps_ms": [67000]
    }
  ],
  "pauses": [
    {
      "start_ms": 15000,
      "end_ms": 18500,
      "duration_ms": 3500,
      "compliant": true,
      "after_dialogue_id": 458
    },
    {
      "start_ms": 95000,
      "end_ms": 102000,
      "duration_ms": 7000,
      "compliant": false,
      "after_dialogue_id": 472
    }
  ]
}
}

Response Fields

Goals

Field	Type	Description
`goal_id`	integer	Goal configuration ID
`goal_name`	string	Goal name
`met`	boolean	Whether the goal was achieved
`score`	number	Confidence score (0-1)
`explanation`	string	AI explanation of the evaluation

Keywords

Field	Type	Description
`keyword_id`	integer	Keyword configuration ID
`keyword_name`	string	Keyword or phrase detected
`sentiment`	string	positive, negative, or neutral
`count`	integer	Number of occurrences
`timestamps_ms`	array	Millisecond timestamps of each occurrence

Pauses

Field	Type	Description
`start_ms`	integer	Pause start time in milliseconds
`end_ms`	integer	Pause end time in milliseconds
`duration_ms`	integer	Pause duration in milliseconds
`compliant`	boolean	Whether pause meets compliance rules
`after_dialogue_id`	integer	ID of dialogue before the pause

Errors

Status	Error	Description
404	”Resource not found”	Recording doesn’t exist

Try It

API Key

Parameters

id*