v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB

Call Log

List User Call Records

Returns call log records filtered by parameters specified.

get/restapi/v1.0/account/{accountId}/extension/{extensionId}/call-log

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Query parameters

extensionNumberstring

Short extension number of a user. If specified, returns call log for this particular extension only. Cannot be combined with phoneNumber filter

phoneNumberstring

Phone number of a caller/callee in e.164 format without a '+' sign. If specified, all incoming/outgoing calls from/to this phone number are returned.

showBlockedboolean

Indicates then calls from/to blocked numbers are returned

directionCallDirectionEnum[]

The direction of call records to be included in the result. If omitted, both inbound and outbound calls are returned. Multiple values are supported

sessionIdstring

Internal identifier of a call session

typeCallTypeEnum[]

The type of call records to be included in the result. If omitted, all call types are returned. Multiple values are supported

transportCallTransportEnum[]

The type of call transport. Multiple values are supported. By default, this filter is disabled

view'Simple' | 'Detailed'

Defines the level of details for returned call records

withRecordingboolean

Deprecated, replaced with recordingType filter, still supported for compatibility reasons. Indicates if only recorded calls should be returned.

If both withRecording and recordingType parameters are specified, then withRecording is ignored

recordingType'Automatic' | 'OnDemand' | 'All'

Indicates that call records with recordings of particular type should be returned. If omitted, then calls with and without recordings are returned

dateTostring date-time

The end of the time range to return call records in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is current time

dateFromstring date-time

The beginning of the time range to return call records in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z. The default value is dateTo minus 24 hours

telephonySessionIdstring

Internal identifier of a telephony session

pageinteger

Indicates the page number to retrieve. Only positive number values are allowed

perPageinteger

Indicates the page size (number of items). The default value is 100. The maximum value for Simple view is 1000, for Detailed view - 250

showDeletedboolean

Indicates that deleted calls records should be returned

Response

Success

uristring uri

Link to the list of company/user call log records

Example response

{
  "paging": {
    "perPage": 50,
    "page": 5,
    "pageEnd": 5,
    "totalPages": 25,
    "totalElements": 25
  }
}