Calls
List all calls
Retrieve a paginated list of calls.
get/calls
Query parameters
pageinteger
The page of results to fetch. Defaults to first page
per_pageinteger
How many results to display per page. Defaults to 25. Max 25.
Headers
Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'
Intercom API version.</br>By default, it's equal to the version set in the app package.
Example:2.14
Response
successful
Example response
{
"type": "list",
"data": [
{
"type": "call",
"id": "123",
"conversation_id": "456",
"admin_id": "789",
"contact_id": "6762f0dd1bb69f9f2193bb83",
"state": "completed",
"recording_url": "https://api.intercom.io/calls/123/recording",
"transcription_url": "https://api.intercom.io/calls/123/transcript",
"call_type": "phone",
"direction": "outbound",
"ended_reason": "completed",
"phone": "+15551234567"
}
],
"pages": {
"type": "pages",
"page": 1,
"next": {
"per_page": 2,
"starting_after": "your-cursor-from-response"
},
"per_page": 2,
"total_pages": 13
}
}