Call Object

A single call-history entry, as returned by the call-fetch endpoints.

Base URL: examples use <vaanii_api_base_url> in place of the Vaanii API address. Contact the Vaanii team at team@vaanii.ai to get it.

Fields

FieldTypeDescription
idUUIDThe call's ID (also the path segment for Get Call).
lead_idUUIDThe lead the call was dialed for, if any.
campaign_idUUIDThe campaign that placed the call.
lead_namestringLead's stored first name.
lead_numberstringLead's E.164 number dialed.
call_attempt_numberintegerWhich attempt on the lead this call is (1-based).
statusstringLifecycle status: pending, in_progress, completed, or failed.
outcomestringResult: answered, no_answer, or failed.
summarystringConcise one-line summary of the call.
duration_secondsintegerCall duration in seconds.
audio_urlstringA signed URL to the call recording, when one exists; null otherwise.
directionstringoutbound or inbound.
call_sourcestringWhat placed the call — see the table below. null on calls made before this field was introduced.
transcriptstringFull call transcript; null until the call completes.
ai_insightsobjectStructured AI analysis: summary, key points, interest level, and suggested next actions. null when AI insights are disabled for the campaign.
created_atdatetimeWhen the call row was created (IST, +05:30).
updated_atdatetimeLast update (IST, +05:30).

Both List Calls and Get Call return this same object, with the same fields.

call_source values

ValueMeaning
cronPlaced automatically by the campaign's calling schedule.
apiPlaced through Make Call with an API key.
manualPlaced from the Lead Directory in the dashboard.
inboundThe customer called your campaign number.
widgetStarted from the web call widget embedded on your site.

api and manual are both operator-triggered and behave identically — they differ only in how the request was authenticated. Both take the lead out of auto-calling; see the note under Make Call.