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/history

Description

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

ParamTypeDescription
campaign_idUUIDRequired. Restrict to one campaign you own.
lead_idUUIDOnly calls made to this lead, newest first.
outcomestringFilter by outcome (answered, no_answer, failed).
start_datestringEarliest call timestamp (inclusive; YYYY-MM-DD or ISO).
end_datestringLatest call timestamp (inclusive; YYYY-MM-DD or ISO).
searchstringA full UUID matches the call id exactly; any other text is a case-insensitive partial match on the lead name or number.
min_duration_secondsintegerOnly calls at least this long; failed calls are excluded.
extraction_fieldstringFilter on an AI extraction-field key.
extraction_valuestringValue the extraction field must equal.
pageintegerPage number, >= 1. Default 1.
per_pageinteger1 – 100. Default 20.

Every call made to one lead:

text
GET /api/v1/calls/history?campaign_id=3f9c1b2a-...&lead_id=b2c3d4e5-...

Errors

StatusDetail
403Campaign not found (when campaign_id does not belong to you).
422Invalid campaign_id or lead_id format (must be a valid UUID).