v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB

Communication

Call History

Returns call history entries for the given lead. Lead must belong to the caller's team.

get/v1.0/communication/call

Query parameters

leadIdinteger required

ID of the lead whose call history to return.

offsetinteger

Zero-based index of the first entry to return.

limitinteger

Number of entries per page.

currentIdinteger

This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.

Headers

Authorizationstring required

Bearer [access_token]

Response

Call history entries for the lead.

Example response

{
  "calls": [
    {
      "id": 563172647619608,
      "dialerCallRecordId": 400000012345,
      "userId": 100234,
      "userPhoneNumber": "+14155550100",
      "leadId": 100001,
      "leadPhoneNumber": "+14155550199",
      "direction": "Outbound",
      "status": "Completed",
      "startTime": "2026-04-22 10:15:00",
      "endTime": "2026-04-22 10:18:45",
      "duration": 225,
      "callingOutcome": "Talked",
      "rateScore": 4,
      "recordingSwitch": true,
      "showUserNumber": "+14155550100",
      "createTime": "2026-04-22 10:15:00",
      "updateTime": "2026-04-22 10:18:45",
      "note": "Discussed pre-approval timeline.",
      "price": 0.02,
      "agentId": 100234,
      "elapsedTime": "00:08"
    }
  ]
}