Revenue

Get call qualification explainability

Returns tenant-scoped CallQualification inspection for a call: status, per-rule results from ruleResultsJson, timestamps, override metadata, and a deterministic explainability summary. Explicitly separates qualification outcome from routing bid evidence (bids are never qualification truth). Unevaluated calls return status PENDING with evaluated=false (not 404). Call context includes campaign/buyer/publisher ids only — never raw phone numbers or provider SIDs. Read-only — never writes CallQualification rows.

GEThttps://api.thearvexa.com/api/calls/{callId}/qualification

Calls

Recent Requests

Time	Status	User Agent
Make a request to see history.

Path Params

callIdstringrequired

Headers

x-organization-idstringrequired

Tenant organization identifier

x-user-rolestringrequired

Development RBAC role (for example SUPER_ADMIN, ORG_ADMIN, OPS_MANAGER, VIEWER)

x-user-idstring

Trusted authenticated actor id (interim header auth). Recorded as the actor on sensitive writes such as finance adjustments and their approve/reject decisions. Ignored when header auth is disabled.

x-organization-idstringrequired

Responses

200Call qualification explainability payloadapplication/json

Call qualification explainability payload

Schema

object

idobject | nullrequired

Null when the call has not been evaluated yet.

organizationIdstringrequired

callIdstringrequired

statusenum(PENDING | PASS | FAIL | OVERRIDDEN)required

evaluatedbooleanrequired

False when no CallQualification row exists yet.

rulesarrayrequired

itemsobject

codeenum(DURATION | FRAUD | DUPLICATE | RECORDING | AFTER_HOURS_INFO)required

outcomeenum(PASS | FAIL | INFO)required

messagestringrequired

mandatorybooleanrequired

When false, outcome never contributes to aggregate FAIL (after-hours INFO).

detailsobjectoptional

Optional PII-safe rule detail scalars.

ruleVersionobject | nullrequired

evaluatedAtobject | nullrequired

overrideobjectrequired

reasonobject | nullrequired

overriddenAtobject | nullrequired

overriddenByUserIdobject | nullrequired

previousStatusenum(PENDING | PASS | FAIL | OVERRIDDEN) | nullrequired

explainabilityobjectrequired

summarystringrequired

Deterministic operator summary from ruleResultsJson (no AI/ML).

routingBidEvidenceobjectrequired

labelstringrequired

example: "Routing bid (evidence)"

isQualificationTruthbooleanrequired

Bids are never qualification truth.

example: false

notestringrequired

conversationIntelligenceobjectrequired

Optional M13 conversation intelligence context when both CALL_INTELLIGENCE_ENABLED and QUALIFICATION_ENGINE_ENABLED are on and intelligence is COMPLETED. Distinct from M9 qualification outcome.

sourcestringrequired

example: "CALL_INTELLIGENCE"

isQualificationTruthbooleanrequired

Conversation intelligence is never qualification truth and never mutates CallQualification.

example: false

notestringrequired

callIntelligenceIdstringrequired

statusstringrequired

example: "COMPLETED"

summaryobject | nullrequired

serviceCategoryLabelobject | nullrequired

serviceCategoryConfidenceobject | nullrequired

urgencyenum(LOW | MEDIUM | HIGH | EMERGENCY) | nullrequired

emergencyLevelenum(NONE | POSSIBLE | CONFIRMED) | nullrequired

sentimentenum(POSITIVE | NEUTRAL | NEGATIVE | MIXED) | nullrequired

conversationQualityScoreobject | nullrequired

M13 conversation rubric 0–100; distinct from M4 CallQualityScore.

humanReviewRequiredbooleanrequired

extractionVersionstringrequired

processedAtobject | nullrequired

qualificationEngineEnabledbooleanrequired

campaignIdobject | nullrequired

Call context id only — never raw phone numbers.

buyerIdobject | nullrequired

publisherIdobject | nullrequired

createdAtobject | nullrequired

updatedAtobject | nullrequired

Example

{
  "organizationId": "string",
  "callId": "string",
  "status": "PENDING",
  "evaluated": true,
  "rules": [],
  "qualificationEngineEnabled": true
}

400Validation error

Validation error

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

403Forbidden for the supplied role

Forbidden for the supplied role

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

404Resource not found

Resource not found

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

← Return to API Reference