v1

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

Call Log

List Company Call Records

Returns call log records filtered by parameters specified.

get/restapi/v1.0/account/{accountId}/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)

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.

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

typeCallTypeEnum[]

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

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

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

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

sessionIdstring

Internal identifier of a call session

telephonySessionIdstring

Internal identifier of a telephony session

pageinteger

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

perPageinteger

Indicates the page size (number of items)

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
  }
}