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
| Field | Type | Description |
|---|---|---|
id | UUID | The call's ID (also the path segment for Get Call). |
lead_id | UUID | The lead the call was dialed for, if any. |
campaign_id | UUID | The campaign that placed the call. |
lead_name | string | Lead's stored first name. |
lead_number | string | Lead's E.164 number dialed. |
call_attempt_number | integer | Which attempt on the lead this call is (1-based). |
status | string | Lifecycle status: pending, in_progress, completed, or failed. |
outcome | string | Result: answered, no_answer, or failed. |
summary | string | Concise one-line summary of the call. |
duration_seconds | integer | Call duration in seconds. |
audio_url | string | A signed URL to the call recording, when one exists; null otherwise. |
direction | string | outbound or inbound. |
call_source | string | What placed the call — see the table below. null on calls made before this field was introduced. |
transcript | string | Full call transcript; null until the call completes. |
ai_insights | object | Structured AI analysis: summary, key points, interest level, and suggested next actions. null when AI insights are disabled for the campaign. |
created_at | datetime | When the call row was created (IST, +05:30). |
updated_at | datetime | Last update (IST, +05:30). |
Both List Calls and Get Call return this same object, with the same fields.
call_source values
| Value | Meaning |
|---|---|
cron | Placed automatically by the campaign's calling schedule. |
api | Placed through Make Call with an API key. |
manual | Placed from the Lead Directory in the dashboard. |
inbound | The customer called your campaign number. |
widget | Started 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.