Skip to main content
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>'
{
  "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.voxfra.com/llms.txt

Use this file to discover all available pages before exploring further.

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

X-API-Key
string
header
required

Your Voxfra management API key. Passed as a request header.

Format: vox_mgmt_<random>

Query Parameters

client_id
string<uuid>

Filter by client UUID

start_date
string<date-time>

ISO 8601 date — return calls on or after this date

end_date
string<date-time>

ISO 8601 date — return calls on or before this date

limit
integer
default:50

Number of results to return (max 200, default 50)

Required range: 1 <= x <= 200
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0

Response

Paginated list of call evaluations

data
object[]
pagination
object