List Calls
Lists call-history entries for your campaigns.
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.
GET
/api/v1/calls/historyDescription
Returns a paginated list of calls belonging to a campaign in your company,
ordered by created_at descending. Supports lead, outcome, date-range,
duration, free-text search, and AI extraction-field filters.
Pass lead_id to retrieve every call made to one lead — inbound calls
included — which is the usual way to build a per-lead call timeline.
Query parameters
| Param | Type | Description |
|---|---|---|
campaign_id | UUID | Required. Restrict to one campaign you own. |
lead_id | UUID | Only calls made to this lead, newest first. |
outcome | string | Filter by outcome (answered, no_answer, failed). |
start_date | string | Earliest call timestamp (inclusive; YYYY-MM-DD or ISO). |
end_date | string | Latest call timestamp (inclusive; YYYY-MM-DD or ISO). |
search | string | A full UUID matches the call id exactly; any other text is a case-insensitive partial match on the lead name or number. |
min_duration_seconds | integer | Only calls at least this long; failed calls are excluded. |
extraction_field | string | Filter on an AI extraction-field key. |
extraction_value | string | Value the extraction field must equal. |
page | integer | Page number, >= 1. Default 1. |
per_page | integer | 1 – 100. Default 20. |
Every call made to one lead:
text
GET /api/v1/calls/history?campaign_id=3f9c1b2a-...&lead_id=b2c3d4e5-...Errors
| Status | Detail |
|---|---|
403 | Campaign not found (when campaign_id does not belong to you). |
422 | Invalid campaign_id or lead_id format (must be a valid UUID). |