List call evaluations
curl --request GET \
--url https://mgmt-api.voxfra.com/v1/calls/evaluations \
--header 'X-API-Key: <api-key>'import requests
url = "https://mgmt-api.voxfra.com/v1/calls/evaluations"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://mgmt-api.voxfra.com/v1/calls/evaluations', 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://mgmt-api.voxfra.com/v1/calls/evaluations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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://mgmt-api.voxfra.com/v1/calls/evaluations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<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://mgmt-api.voxfra.com/v1/calls/evaluations")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mgmt-api.voxfra.com/v1/calls/evaluations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"status": "completed",
"updated_at": "2026-05-08T10:18:00Z",
"call": {
"id": "11111111-1111-1111-1111-111111111111",
"client_id": "00000000-0000-0000-0000-000000000002",
"created_at": "2026-05-08T10:00:00Z",
"caller_full_name": "Jane Smith",
"caller_phone_number": "+15551234567",
"call_summary": "Customer asked about service availability."
},
"lead_quality": {
"state": "completed",
"completed_at": "2026-05-08T10:15:00Z",
"result": {
"overall_score": 4.5,
"sentiment": {
"value": "positive",
"rationale": "Caller remained upbeat throughout."
},
"flags": {
"negative_call": false,
"human_review_required": false,
"review_reason": null
},
"scores": {
"lead_completion": {
"score": 5,
"rationale": null
},
"clarity_politeness": {
"score": 4,
"rationale": "The agent stayed concise and polite."
},
"relevance_questions": {
"score": 4,
"rationale": "Questions matched the caller intent."
},
"objection_handling": {
"score": 3,
"rationale": "Handled objections but missed a follow-up."
},
"naturalness": {
"score": 4,
"rationale": "The delivery sounded conversational."
},
"lead_intent": {
"score": 5,
"rationale": "Caller clearly wanted a booking."
},
"failure_risk": {
"score": 2,
"rationale": "Only minor drop-off risk surfaced."
}
}
}
},
"prompt_adherence": {
"state": "completed",
"completed_at": "2026-05-08T10:18:00Z",
"result": {
"score": 4,
"critical_failures_summary": null,
"what_went_well": [
"Used the approved greeting",
"Captured callback preference"
],
"what_went_wrong": [
"Skipped one pricing disclaimer"
],
"recommendations_for_improvement": [
"Ask the disclaimer question before transfer"
],
"prompt": {
"system_instruction": "Always greet the caller and confirm callback preference.",
"system_variables": {
"dealership_name": "Northside Auto",
"escalation_phone": "+14165550123"
}
}
}
}
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 1
}
}{
"error": "Unauthorized"
}{
"error": "Client not found"
}{
"error": "Internal Server Error",
"message": "Unexpected error"
}Evaluations
List Call Evaluations
Returns evaluation resources for calls in the authenticated organization.
Supports the same pagination and call filters as GET /v1/calls, but each item includes explicit evaluation workflow state and the currently available evaluation payload for that call.
GET
/
v1
/
calls
/
evaluations
List call evaluations
curl --request GET \
--url https://mgmt-api.voxfra.com/v1/calls/evaluations \
--header 'X-API-Key: <api-key>'import requests
url = "https://mgmt-api.voxfra.com/v1/calls/evaluations"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://mgmt-api.voxfra.com/v1/calls/evaluations', 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://mgmt-api.voxfra.com/v1/calls/evaluations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <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://mgmt-api.voxfra.com/v1/calls/evaluations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<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://mgmt-api.voxfra.com/v1/calls/evaluations")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mgmt-api.voxfra.com/v1/calls/evaluations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"status": "completed",
"updated_at": "2026-05-08T10:18:00Z",
"call": {
"id": "11111111-1111-1111-1111-111111111111",
"client_id": "00000000-0000-0000-0000-000000000002",
"created_at": "2026-05-08T10:00:00Z",
"caller_full_name": "Jane Smith",
"caller_phone_number": "+15551234567",
"call_summary": "Customer asked about service availability."
},
"lead_quality": {
"state": "completed",
"completed_at": "2026-05-08T10:15:00Z",
"result": {
"overall_score": 4.5,
"sentiment": {
"value": "positive",
"rationale": "Caller remained upbeat throughout."
},
"flags": {
"negative_call": false,
"human_review_required": false,
"review_reason": null
},
"scores": {
"lead_completion": {
"score": 5,
"rationale": null
},
"clarity_politeness": {
"score": 4,
"rationale": "The agent stayed concise and polite."
},
"relevance_questions": {
"score": 4,
"rationale": "Questions matched the caller intent."
},
"objection_handling": {
"score": 3,
"rationale": "Handled objections but missed a follow-up."
},
"naturalness": {
"score": 4,
"rationale": "The delivery sounded conversational."
},
"lead_intent": {
"score": 5,
"rationale": "Caller clearly wanted a booking."
},
"failure_risk": {
"score": 2,
"rationale": "Only minor drop-off risk surfaced."
}
}
}
},
"prompt_adherence": {
"state": "completed",
"completed_at": "2026-05-08T10:18:00Z",
"result": {
"score": 4,
"critical_failures_summary": null,
"what_went_well": [
"Used the approved greeting",
"Captured callback preference"
],
"what_went_wrong": [
"Skipped one pricing disclaimer"
],
"recommendations_for_improvement": [
"Ask the disclaimer question before transfer"
],
"prompt": {
"system_instruction": "Always greet the caller and confirm callback preference.",
"system_variables": {
"dealership_name": "Northside Auto",
"escalation_phone": "+14165550123"
}
}
}
}
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 1
}
}{
"error": "Unauthorized"
}{
"error": "Client not found"
}{
"error": "Internal Server Error",
"message": "Unexpected error"
}Use this endpoint for dashboard tables, review queues, and date-range reports that need evaluation workflow state across many calls.
Each item includes lightweight call context plus the evaluation state and payload available for that call at read time. If you need one stable record for a single call, use /api-reference/calls/get-evaluations.
Authorizations
Your Voxfra management API key. Passed as a request header.
Format: vox_mgmt_<random>
Query Parameters
Filter by client UUID
ISO 8601 date — return calls on or after this date
ISO 8601 date — return calls on or before this date
Number of results to return (max 200, default 50)
Required range:
1 <= x <= 200Number of results to skip for pagination
Required range:
x >= 0Was this page helpful?
⌘I