Call Logs

Retrieve call history and details using the CometChat REST API. Call logs provide information about past calls including participants, duration, and recording URLs.

Retrieving Call Logs

Call logs are accessed through the CometChat REST API rather than the client SDK. Use the following endpoints:

List Calls

Retrieve a list of calls for your app:

GET https://{{appId}}.api-{{region}}.cometchat.io/v3/calls

See the List Calls API documentation for full details on parameters and response format.

Get Call Details

Retrieve details for a specific call:

GET https://{{appId}}.api-{{region}}.cometchat.io/v3/calls/{{sessionId}}

See the Get Call API documentation for full details.

Call Log Properties

Property	Type	Description
`sessionId`	String	Unique identifier for the call session
`initiator`	Object	User who initiated the call
`receiver`	Object	User or group that received the call
`type`	String	Call type: `audio` or `video`
`status`	String	Call status: `initiated`, `ongoing`, `ended`, etc.
`startedAt`	Number	Unix timestamp when the call started
`endedAt`	Number	Unix timestamp when the call ended
`duration`	Number	Call duration in seconds
`participants`	Array	List of participants who joined
`recordingUrl`	String	URL to the call recording (if recorded)

Transcripts

Available since v5.0.5 Use CallLogRequestBuilder to fetch only calls that were transcribed. Opting in also makes the server attach each call’s transcripts to the log:

const callLogRequest = new CometChatCalls.CallLogRequestBuilder()
  .setLimit(30)
  .setHasTranscriptions(true)
  .build();

const callLogs = await callLogRequest.fetchNext();

callLogs.forEach((callLog) => {
  callLog.getTranscriptions().forEach((transcription) => {
    console.log(transcription.getTid(), transcription.getTranscriptURL());
  });
});

getTranscriptions() returns an empty array when the server omitted transcripts, so it never needs a null check. To page through a session’s transcripts directly, use TranscriptRequestBuilder.

Overview

Integrations

Getting Started

Call Session

Features

Advanced

Migration Guide

Resources

Retrieving Call Logs

List Calls

Get Call Details

Call Log Properties

Transcripts

​Retrieving Call Logs

​List Calls

​Get Call Details

​Call Log Properties

​Transcripts

​Related Documentation

Retrieving Call Logs

List Calls

Get Call Details

Call Log Properties

Transcripts

Related Documentation