Skip to Content
CallMitraDocs
API referenceCalls

List calls

Newest first. For deep lists pass `cursor` (empty for the first page, then the `nextCursor` you got back): cursor pages skip the total count and stay fast. Without `cursor` the list pages by `page` and counts matches up to 10,000.

GET
/api/v1/calls/

Newest first. For deep lists pass cursor (empty for the first page, then the nextCursor you got back): cursor pages skip the total count and stay fast. Without cursor the list pages by page and counts matches up to 10,000.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Query Parameters

page?Page

Page number, from 1. Ignored when cursor is sent.

Range1 <= value
Default1
limit?Limit

Items per page, up to 200.

Range1 <= value <= 200
Default25
cursor?|

Empty for the first page, then the previous response's nextCursor.

search?|

Matches the phone number, customer name or phone, summary, or call name.

agentId?|

Only calls of this agent.

leadId?|

Only calls to this lead.

campaignId?|

Only calls of this campaign.

outcome?string

Only calls with this outcome.

Value in"qualified""interested""callback""not_interested""no_response""no_answer""busy""call_failed""voicemail"""
sentiment?string

Only calls with this sentiment.

Value in"positive""neutral""negative"
channel?|

instant, bulk, inbound, or browser (test calls).

hasRecording?string

Only calls with (true) or without (false) a recording.

Value in"true""false"
dateFilter?string

today = started since 00:00 UTC today; week / month = started in the last 7 / 30 days (rolling); all or omitted = no date filter.

Value in"today""week""month""all"
includeTests?Includetests

Include browser test calls.

Defaulttrue

Response Body

OK

application/json
  1. response

A page of calls, newest first.

calls*array<>

Calls on this page, newest first.

hasMore?Hasmore

True when another page follows.

Defaultfalse
nextCursor?|

Pass as cursor to get the next page; null on the last page or in page mode.

pagination*

Where this page sits in the full list.

success?Success

Always true on a 2xx response.

Defaulttrue
[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/calls/'
Example Response
{  "calls": [    {      "agentId": "4f6d2c1a-9b7e-4c3d-8a21-5e0f7b9c1d23",      "agentName": "Priya",      "billableMinutes": 2,      "billedInr": 9,      "callType": "manual",      "campaignId": "e3f4a5b6-c7d8-4e9f-a0b1-c2d3e4f5a6b7",      "campaignName": "Priya instant calls",      "channel": "instant",      "createdAt": "2026-11-14T10:02:09Z",      "duration": 94,      "endTime": "2026-11-14T10:03:45Z",      "endedReason": "customer-ended-call",      "extractedFields": {        "delivery_slot": "morning"      },      "fromNumber": "+918045671234",      "hasRecording": true,      "id": "8c1e5b7a-2d4f-4e9a-b6c3-1f0a9d8e7b65",      "isEscalated": false,      "leadId": "b2a7c9d1-6e3f-4a8b-9c0d-1e2f3a4b5c6d",      "leadName": "Asha Verma",      "merchantOutcome": "interested",      "metadata": {        "crmId": "0065g00000XyZ"      },      "outcome": "successful",      "outcomeCategory": "interested",      "phoneNumber": "+919812345678",      "phoneNumberId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",      "sentiment": "positive",      "startTime": "2026-11-14T10:02:11Z",      "status": "completed",      "summary": "Customer confirmed Friday delivery and asked for a morning slot.",      "transcript": "Assistant: Hi Asha, this is Priya from Acme about order A-1042.\nUser: Yes, go ahead.",      "updatedAt": "2026-11-14T10:03:52Z"    }  ],  "hasMore": false,  "pagination": {    "currentPage": 1,    "hasNextPage": false,    "hasPreviousPage": false,    "itemsPerPage": 25,    "totalCapped": false,    "totalItems": 1,    "totalPages": 1  },  "success": true}