Get Results

Retrieve goal achievements and pause analysis for a recording.

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

Get AI-powered analysis including goal evaluation 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.ai/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.ai/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("\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.ai/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('\nPauses:');
results.pauses.forEach(pause => {
  const duration = (pause.duration_ms / 1000).toFixed(1);
  const compliance = pause.compliant ? 'compliant' : 'non-compliant';
  console.log(`  - ${duration}s pause at ${pause.start_ms}ms (${compliance})`);
});

PHP


<?php
$apiKey = getenv('IDENTITYCALL_API_KEY');
$recordingId = 123;
 
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.identitycall.ai/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.ai/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."
    }
  ],
  "client_assessment": {
    "percentage": 50,
    "met_count": 1,
    "total_count": 2,
    "conflict": false,
    "criteria": [
      { "name": "Clear question", "met": true, "reasoning": "The client asked about the VAT return deadline." },
      { "name": "Polite", "met": false, "reasoning": "The client interrupted the agent several times." }
    ]
  },
  "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

Client assessment

How the customer did against the project’s client criteria. It is scored separately and never changes the operator’s score. null when the call was not assessed (no client criteria, or not processed yet). The second leg of a paired call returns the primary leg’s rating.

Field	Type	Description
`percentage`	integer \| null	Share of criteria met, rounded (0-100); `null` with no criteria
`met_count`	integer	Criteria met
`total_count`	integer	Criteria asked
`conflict`	boolean	The call shows a conflict with the client
`criteria`	array	`{ name, met, reasoning }` per criterion, as it was asked on this call

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*