Skip to main content
GET
/
v1
/
calls
/
{id}
/
evaluations
Get call evaluations
curl --request GET \
  --url https://mgmt-api.voxfra.com/v1/calls/{id}/evaluations \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "call_id": "11111111-1111-1111-1111-111111111111",
    "status": "partial",
    "updated_at": "2026-05-08T10:15: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": "pending",
      "completed_at": null,
      "result": null
    }
  }
}

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 to retrieve the evaluation artifact for a single call. It exposes explicit workflow state, score and rationale fields for lead quality, and the evaluated prompt snapshot for prompt-adherence reviews when available. A missing call returns 404; a call with no finished evaluation rows still returns 200 with pending or partial state.

Authorizations

X-API-Key
string
header
required

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

Format: vox_mgmt_<random>

Path Parameters

id
string<uuid>
required

Call UUID

Response

Call evaluation resource

data
object