List calls
Calls on your lines, newest first, with caller, line, outcome and tags.
GET https://cotlet.dev/api/v1/aircall/calls
read
Lists calls as the Calls view of Aircall Workspace shows them, newest first. Each row has the caller, the Aircall line, the teammate, direction, duration, the missed reason for unanswered calls, the tags and whether a note exists. Missed reasons use the values of Aircall Call History, such as agents_did_not_answer, no_available_agent or out_of_opening_hours. Filter by date range, direction, missed, line, teammate or tag. Page with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| since date | date | Calls from this date. |
| until date | date | Calls up to this date. |
| direction enum | enum | inbound or outbound. |
| missed boolean | boolean | true: only calls nobody answered. |
| line string | string | Aircall line, by name or number. |
| user string | string | Teammate, by name as Aircall shows it. |
| tag string | string | Only calls with this tag label. |
| limit integer | integer | Page size. |
| cursor string | string | next_cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/aircall/calls \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("aircall", "list_calls")const result = await cotlet.call('aircall', 'list_calls');cotlet call aircall list_callsExample response
{
"calls": [
{
"call_id": "1437759201",
"direction": "inbound",
"status": "missed",
"missed_call_reason": "agents_did_not_answer",
"caller": {
"name": "Priya Raman",
"number": "+14155550142"
},
"line": "Sales US",
"user": null,
"duration_seconds": 0,
"started_at": "2026-10-22T16:41:08Z",
"tags": [
"Callback Request"
],
"has_note": false
},
{
"call_id": "1437758774",
"direction": "inbound",
"status": "answered",
"missed_call_reason": null,
"caller": {
"name": "Luis Ortega",
"number": "+14155550177"
},
"line": "Support",
"user": "Ana Silva",
"duration_seconds": 412,
"started_at": "2026-10-22T15:02:51Z",
"tags": [],
"has_note": false
}
],
"next_cursor": null
}