List terminated calls
Retrieve a paginated list of terminated calls for your team, ordered by most recent first. All query parameters are optional — when omitted, defaults apply (last 15 days, 100 results).
For advanced filtering (by tags, stars, users, IVRs, groups), use POST /calls instead.
Permission: Calls Read required.
Monitoring: This route always returns all team calls regardless of the Monitoring flag. The Monitoring setting has no effect on call listing — the underlying stats service does not filter by user. This applies identically whether Monitoring is ON or OFF.
Date range: If start_date and end_date are not provided, defaults to the last 15 days. Maximum allowed range is 15 days.
Pagination: Two strategies are available — offset-based (limit_offset) for browsing and cursor-based (last_id_returned) for deep pagination beyond 9000 records.
Note: Multiple items may share the same call_id — this occurs when a call is transferred or routed through an IVR. You will notice changes in from_number/to_number or scenario_name/scenario_id.
Query parameters
Start of the date range (inclusive). Must be used together with end_date. Defaults to 15 days ago at midnight UTC.
End of the date range (inclusive). Must be used together with start_date. The difference between start_date and end_date must not exceed 15 days. Defaults to tomorrow at midnight UTC.
Maximum number of calls to return. Default: 100.
Number of calls to skip for pagination. Default: 0.
Cursor-based pagination: returns call logs with a cdr_id lower than this value. Alternative to limit_offset for deep pagination.
Filter by call type. Can be specified multiple times (e.g., ?call_type=ANSWERED&call_type=MISSED).
[Deprecated] Sort order. Calls are returned in descending order by default.
Response
Successful operation
Example response
{
"user_id": 123456,
"team_id": 654321,
"limit_count_setted": 100,
"limit_offset_setted": 100,
"last_id_offset_setted": 19479170,
"call_list_count": 1,
"call_list": [
{
"cdr_id": 19479175,
"call_id": "9058220947198957713",
"channel_id": "9058220947198957713",
"type": "PHONE",
"direction": "in",
"last_state": "VOICEMAIL",
"start_time": "2017-04-13T15:27:36+02:00",
"answered_time": "2017-04-13T15:27:46+02:00",
"end_time": "2017-04-13T15:27:56+02:00",
"incall_duration": 10,
"total_duration": 20,
"from_number": "33600000000",
"to_number": "33184800000",
"note": "Potential client",
"star": "STAR1",
"tags": [
{
"tag_id": 123,
"name": "mytag",
"color": "ff6b6b",
"description": "my tag description",
"creation_date": "2018-08-12T12:12:40.53Z"
}
],
"record": "https://cdn.ringover.com/records/0-0/35537d8679f3e2-13-04-19-15h27-33600000000-33180800000.mp3",
"user": {
"user_id": 123456,
"team_id": 123456,
"initial": "PM",
"color": "3CC8C8",
"firstname": "Pauline",
"lastname": "Martin",
"company": "Ringover",
"email": "pauline.martin@ringover.com",
"picture": "https://cdn77.ringover.com/img/users/default.jpg",
"concat_name": "Pauline Martin"
},
"conference": {
"conference_id": 60908,
"name": "SoConference",
"numbers": [
{
"number": 33184800000,
"label": "myfavoritenumber",
"type": "PHONE",
"user_id": 60907,
"ivr_id": 60908,
"conference_id": 60908,
"format": {
"raw": 184800000,
"country_code": "33",
"country": "FR",
"e164": "+33184800000",
"international": "+33 1 84 80 00 00",
"international_alt": "33184800000",
"national": "01 84 80 00 00",
"national_alt": "0184800000",
"rfc3966": "tel:+33-1-84-80-00-00"
}
}
]
},
"ivr": {
"ivr_id": 123456,
"name": "StandardFacile",
"color": "ff6b6b"
},
"contact": {
"contact_id": 654321,
"is_shared": true,
"social_service_id": "00P7U000015Ei75YBX",
"firstname": "John",
"lastname": "Do",
"company": "DoeCompany",
"concat_name": "John Doe",
"color": "3CC8C8",
"initial": "JD",
"creation_date": "2018-08-12T12:12:40.53Z",
"numbers": [
331797500010
]
}
}
],
"total_call_count": 1337,
"total_missed_call_count": 4
}