# getCallHistory

Description

Get the list of recent calls

void getCallHistory(int iCount)

Parameters

Name Description
iCount The number of requested calls

Response example

{
    "method": "getCallHistory",
    "requestId" : "1",
    "calls":
    [
        {
            "type": 1,
            "confType": 0,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540306165,
            "duration": 374,
            "viewed": false,
            "streamId": "000002d5@some.server#vcs"
        },
        {
            "type": 1,
            "confType": 1,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540305383,
            "duration": 8,
            "viewed": false,
            "confId": "000002d5@some.server#vcs",
            "streamId": "000002d5@some.server#vcs"
        },
        {
    "type": 1,
            "confType": 1,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540304614,
            "duration": 1,
            "viewed": false,
            "confId": "000002d5@some.server#vcs",
            "streamId": "000002d5@some.server#vcs"
        }
    ],
    "lastView": 1643982219,
    "result": true
}

Response Parameters

Name Description
calls The list of calls
lastView The timestamp indicating when the call history was last viewed
type The type of call or conference call:
• 0 — Incoming
• 1 — Outgoing
• 2 — Missed
confType The type of communication session:
• 0 — Video call
• 1 — Group conference
confTitle A group conference title (this field is unavailable for `video calls`)
peerId The unique identifier (TrueConf ID) of a user who received an incoming call from TrueConf VideoSDK or made a call to TrueConf VideoSDK
peerDn The display name of a user who has the given `peerId`
confId The unique session identifier (available only for a group conference)
startTime The call start time
duration Call duration
viewed Flag showing whether the call was "viewed"
requestId A unique request identifier
result A flag indicating whether the request was successful

See also

Last Updated: 09/12/2025