Call Logs

Fetch, filter, and display call history in your React Native app using CometChat Calls SDK — including call duration, participants, direction, and recording status.

Quick Reference - Fetch call logs:

const loggedInUser = await CometChat.getLoggedinUser();

let callLogRequest = new CometChatCalls.CallLogRequestBuilder()
  .setLimit(30)
  .setAuthToken(loggedInUser.getAuthToken())
  .setCallCategory("call")
  .build();

const callLogs = await callLogRequest.fetchNext();

Available via: SDK | REST API | UI Kits

Overview

CometChat’s React Native Call SDK provides a comprehensive way to integrate call logs into your application, enhancing your user experience by allowing users to effortlessly keep track of their communication history. Call logs provide crucial information such as call duration, participants, and more.

This feature not only allows users to review their past interactions but it also serves as an effective tool to revisit important conversation details. With the flexibility of fetching call logs, filtering them according to specific parameters, and obtaining detailed information of individual calls, application developers can use this feature to build a more robust and interactive communication framework.

In the following sections, we will guide you through the process of working with call logs, offering a deeper insight into how to optimally use this feature in your React Native application.

Fetching Call Logs

To fetch all call logs in your React Native application, you should use the CallLogRequestBuilder, This builder allows you to customize the call logs fetching process according to your needs.

let callLogRequestBuilder = new CometChatCalls.CallLogRequestBuilder()
        .setLimit(30)
        .setAuthToken(loggedInUser.getAuthToken())
        .setCallCategory("call")
        .build()

CallLogRequestBuilder has the following settings available.

Setting	Description
setLimit(limit: number)	Specifies the number of call logs to fetch.
setCallType(callType: 'video' or 'audio')	Sets the type of calls to fetch (call or meet).
setCallStatus(callStatus: 'ongoing' or 'busy' or 'rejected' or 'cancelled' or 'ended' or 'missed')	Sets the status of calls to fetch (initiated, ongoing, etc.)
setHasRecording(hasRecording: boolean)	Sets whether to fetch calls that have recordings.
setCallCategory(callCategory: 'call' or 'meet')	Sets the category of calls to fetch (call or meet).
setCallDirection(callDirection: 'incoming' or 'outgoing')	Sets the direction of calls to fetch (incoming or outgoing)
setUid(uid: string)	Sets the UID of the user whose call logs to fetch.
setGuid(guid: string)	Sets the GUID of the user whose call logs to fetch.
setAuthToken(authToken: string)	Sets the Auth token of the logged-in user.

Fetch Next

The fetchNext() method retrieves the next set of call logs.

let callLogRequestBuilder = new CometChatCalls.CallLogRequestBuilder()
    .setLimit(30)
    .setAuthToken(loggedInUser.getAuthToken())
    .setCallCategory("call")
    .build()

callLogRequestBuilder.fetchNext()
  .then(callLogHistory => {
    console.log(callLogHistory);
  })
  .catch(err => {
     console.log(err);
  });

Response

On Success — fetchNext() returns an array of CallLog objects:

CallLog Array:

Parameter	Type	Description	Sample Value
(array)	array	Array of call log objects	See below ↓

CallLog Object (each item in array):

Parameter	Type	Description	Sample Value
sessionId	string	Unique session identifier	"v1.in.2748663902141719.1772100619..."
totalAudioMinutes	number	Total audio duration in minutes	7.65
totalVideoMinutes	number	Total video duration in minutes	0
totalDuration	string	Formatted total duration	"00:07:39"
totalDurationInMinutes	number	Total duration in minutes	7.65
hasRecording	boolean	Whether call has recordings	true
initiatedAt	number	Unix timestamp when call was initiated	1772100619
startedAt	number	Unix timestamp when call started	1772100622
endedAt	number	Unix timestamp when call ended	1772101081
initiator	object	User who initiated the call	See below ↓
receiver	object	User who received the call	See below ↓
mode	string	Call mode	"call"
receiverType	string	Type of receiver	"user"
status	string	Call status	"ended"
totalParticipants	number	Total number of participants	2
type	string	Type of call	"audio"
mid	string	Message ID	"21d6e797-1b44-4a70-be73-d915dba206c7"
participants	array	List of call participants	See below ↓
recordings	array	List of recordings	See below ↓
data	object	Additional call data	See below ↓

---

initiator Object:

Parameter	Type	Description	Sample Value
uid	string	Unique user identifier	"cometchat-uid-7"
name	string	Display name of the user	"Henry Marino"
avatar	string	URL to user’s avatar image	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-7.webp"

---

receiver Object:

Parameter	Type	Description	Sample Value
uid	string	Unique user identifier	"cometchat-uid-6"
name	string	Display name of the user	"Ronald Jerry"
avatar	string	URL to user’s avatar image	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"

---

participants Array:

Parameter	Type	Description	Sample Value
(array)	array	Array of participant objects	See below ↓

Participant Object (each item in array):

Parameter	Type	Description	Sample Value
uid	string	Unique user identifier	"cometchat-uid-6"
name	string	Display name of the user	"Ronald Jerry"
avatar	string	URL to user’s avatar image	"https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-6.webp"
totalAudioMinutes	number	User’s audio duration in minutes	7.65
totalVideoMinutes	number	User’s video duration in minutes	0
totalDurationInMinutes	number	User’s total duration in minutes	7.65
isJoined	boolean	Whether user joined the call	true
state	string	Participant state	"ended"
deviceId	string	Device identifier	"2b1d0b90-b6b9-4c1c-9899-9bf4effe549f@..."
joinedAt	number	Unix timestamp when user joined	1772100622
leftAt	number	Unix timestamp when user left	1772101081
mid	string	Message ID	"21d6e797-1b44-4a70-be73-d915dba206c7"

---

recordings Array:

Parameter	Type	Description	Sample Value
(array)	array	Array of recording objects	See below ↓

Recording Object (each item in array):

Parameter	Type	Description	Sample Value
rid	string	Recording ID	"noujausedimwfhwl"
recording_url	string	URL to download the recording	"https://recordings-in.cometchat.io/..."
duration	number	Recording duration in minutes	1.045
startTime	number	Unix timestamp when recording started	1772100632
endTime	number	Unix timestamp when recording ended	1772100634

---

data Object:

Parameter	Type	Description	Sample Value
entities	object	Entity details for the call	See below ↓

data.entities Object:

Parameter	Type	Description	Sample Value
initiator	object	Initiator entity wrapper	See below ↓
receiver	object	Receiver entity wrapper	See below ↓

data.entities.initiator Object:

Parameter	Type	Description	Sample Value
entity	object	User entity details	{"uid": "cometchat-uid-7", "name": "Henry Marino", "avatar": "..."}

data.entities.receiver Object:

Parameter	Type	Description	Sample Value
entity	object	User entity details	{"uid": "cometchat-uid-6", "name": "Ronald Jerry", "avatar": "..."}

Fetch Previous

The fetchPrevious() method retrieves the previous set of call logs.

let callLogRequestBuilder = new CometChatCalls.CallLogRequestBuilder()
    .setLimit(30)
    .setAuthToken(loggedInUser.getAuthToken())
    .setCallCategory("call")
    .build()

callLogRequestBuilder.fetchPrevious()
  .then(callLogHistory => {
    console.log(callLogHistory);
  })
  .catch(err => {
     console.log(err);
  });

Response

On Success — fetchPrevious() returns an array of CallLog objects with the same structure as fetchNext(). See fetchNext Response for the complete object structure.

Get Call Details

To retrieve the specific details of a call, use the getCallDetails() method. This method requires the Auth token of the logged-in user and the session ID along with a callback listener.

var sessionID = "SESSION_ID";
CometChatCalls.getCallDetails(sessionID, authToken)
.then((callLogs: Array<CallLog>) => {
    console.log(callLogs);
  })
  .catch(err => {
    console.log(err);
  });

Response

On Success — getCallDetails() returns an array of CallLog objects with the same structure as fetchNext(). See fetchNext Response for the complete object structure.

Replace "SESSION_ID" with the ID of the session you are interested in.

Best Practices

Use pagination for large call histories

Always use fetchNext() with a reasonable setLimit() value (e.g., 20-30) rather than fetching all logs at once. This improves performance and reduces memory usage, especially for users with extensive call histories.

Filter logs for specific views

Use the builder’s filter methods (setCallType, setCallStatus, setCallDirection) to fetch only the logs relevant to your current UI view. For example, show only missed calls in a “Missed” tab rather than filtering client-side.

Cache call logs locally

Consider caching fetched call logs locally to reduce API calls and improve load times. Use fetchNext() to load newer logs and fetchPrevious() for older ones as the user scrolls.

Troubleshooting

Call logs return empty

Verify that the authToken passed to setAuthToken() is valid and belongs to the logged-in user. Also check that calls have actually been made — call logs are only generated after a call session completes.

fetchNext returns the same results

Ensure you’re reusing the same callLogRequestBuilder instance for pagination. Creating a new builder resets the cursor, causing the same page to be fetched repeatedly.

getCallDetails returns no data

Confirm the sessionID is correct and corresponds to a completed call. Active or in-progress calls may not have full details available yet.

---

Next Steps

Ringing

Implement a complete calling experience with incoming and outgoing call UI

Call Session

Start and manage call sessions with full configuration options

Recording

Record call sessions for playback and compliance

Standalone Calling

Implement calling without the Chat SDK