Downloading Call log using RingCentral Call Log API endpoint — Quick Tip

RingCentral offers Call Log API call-log to fetch call-log records for completed calls approximately 30 seconds after the end of the call

Here is the API endpoint for fetching call-log:

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

When using the Online Account Portal, the calls are presented in a single merged view. You can see that here:

Login to service.ringcentral.com (production) or service.devtest.ringcentral.com (sandbox) → Call Log

Call Log API

There are several routes available for accessing specific types of call log data.

The base route for accessing call log data is scoped to the Account Level or the Extension Level depending upon the role of the authenticated access_token user.

Account-Level Call Log data (this is data for the entire account):

/restapi/v1.0/account/{accountId}/call-log /restapi/v1.0/account/{accountId}/call-log/{callRecordId}

or Extension-Level Call Log data (this is data for only a specific extension within your RingCentral account):

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

A call record can be associated with multiple extensions. There are several ways to associate and retrieve the simple/detailed call log with call legs and then match each call leg to the associated extension.

You retrieve Simple Call Log records with call legs by retrieving the Call Log endpoint with the view=Simple query parameter, for example v1.0/account/{accountId}/extension/{extensionID}/call-log?view=Simple. Extension Level Call Log List are the Call Logs associated with the currently authenticated access_token user account credentials.

You retrieve Detailed Call Log records with call legs by retrieving the Call Log endpoint with the view=Detailed query parameter, for example v1.0/account/{accountId}/extension/{extensionID}/call-log?view=Detailed. Detailed Call Log is available if you wish to obtain the details of a single call log item, you could fetch a single record, you could use sessionId or id query parameter to fetch per sessionId or per call record id. When the simple Call Log data does not provide enough granularity you can leverage the Detailed Call Log data at both the Account and Extension level.

The call-log API by default can fetch up to 100 call records at a time. You can specifically fetch the number of records to be retrieved via call-log api by using perPage=XXX query parameter. As call-log API call belongs to heavy api group , we recommend you to fetch not more than 200 records per api call.

Next Steps

Feel free to comment on this blog to add more commonly seen Call Log issues/errors and I shall edit this blog and add few more tips/quirks on how to handle those issues.

Thats it. Now you are ready to rock and roll :)

To learn more about RingCentral Developer Program and start building cool integrations using RingCentral API’s visit https://developer.ringcentral.com/

For other RingCentral Developer Program related articles, visit our medium page by clicking here.

Learn more about our Developer Program here: https://developer.ringcentral.com/