Call Logs and Analytics

tip

Webhooks are recommended for a more robust and scalable approach to retrieve call logs.

Retrieve Call Logs

Retrieve call logs based on filters provided in query parameters. All parameters are optional.

This endpoint returns a paginated response.

Reference

For understanding the response fields, see:

• Call Statuses — Explanation of all possible call status values
• Call Creator — How the creator field is determined

GET /integrations/calls/

Headers

Name	Value
Authorization	Bearer Access Token

Query Parameters

Name	Type	Required	Description
call_id	string	No	call_id obtained on initiating the call or in webhook response
candidate_id	string	No	Custom Metadata Field
candidate_number	string	No	Callee Number (E.164 format)
date	string	No	Start date in DD/MM/YY H:M:S format
date_end	string	No	End date in DD/MM/YY H:M:S format
event_id	string	No	event_id obtained on initiating the call
job_id	string	No	Custom Metadata Field
recruiter_email	string	No	Email of FreJun user
transaction_id	string	No	Custom Metadata Field

Response

{
 "success": true,
 "message": "Successfully retrieved calls data",
 "data": {
  "count": 123,
  "next": "<URL for next page>",
  "previous": "<URL for previous page>",
  "results": [
   {
    "id": "<numeric id of the call log (deprecated, use call_id instead)>",
    "call_id": "<call id in hash format>",
    "transaction_id": "<transaction_id provided during call initiation / updation>",
    "job_id": "<job_id provided during call initiation / updation>",
    "candidate_id": "<candidate_id provided during call initiation / updation>",
    "candidate_number": "<candidate number in E.164 format>",
    "candidate_name": "<candidate name>",
    "creator_number": "<FreJun User's real number (E.164 format). Only used in network calling.>",
    "virtual_number": "<FreJun virtual number used for the call (E.164 format)>",
    "link": "<link to access the recording and call details in FreJun>",
    "status": "<Call status - call-initiating..., answered, not-answered, not-initiated, ongoing.., user-busy, busy, not_available, user-not-available/not-reachable, user-not-answered, blocked, DND/DNCR>",
    "call_start_time": "<E.g, 2026-02-07T11:37:30.846260>",
    "call_end_time": "<E.g, 2026-02-07T11:37:40.868769>",
    "call_duration": "<Duration of the call in minutes>",
    "call_type": "<incoming/outgoing>",
    "recruiter": "<email of the user in FreJun who made/received the call>",
    "call_reason": "<reason for the call, if provided>",
    "call_outcome": "<outcome of the call, if provided>",
    "recruiter_notes": "<notes added by the user in FreJun regarding the call>",
    "recording_url": "<link to the recording of the call, if available>",
    "campaign_name": "<campaign_name if the call was part of a campaign (AutoDial)>",
    "call_transcript": [
     {
      "end": "<end time of the transcript segment in milliseconds>",
      "text": "<transcribed text for the segment>",
      "start": "<start time of the transcript segment in milliseconds>",
      "speaker": "<A / B>"
     }
    ],
    "ai_insights": {
     "talk_ratio": {
      "speaker A": "<percentage of time speaker A spoke during the call>",
      "speaker B": "<percentage of time speaker B spoke during the call>"
     },
     "sentiment_score": {
      "sentiment": "<positive/negative/neutral>",
      "percentage": "<percentage of the call that had this sentiment>",
      "sentiment_summary": "<brief summary of the sentiment in the call>"
     },
     "summary": {
      "transcript_summary": "<brief summary of the call based on the transcript>",
      "action_items": "<list of action items mentioned in the call>"
     },
     "questions_covered": {
      "number": "<number of questions covered in the call>",
      "percentage": "<percentage of the call that had questions>"
     },
     "qa": [
      {
       "question": "<question asked during the call>",
       "answer": "<answer given during the call>"
      }
     ]
    },
    "cost": "<cost of the call, if available>"
   }
  ]
 }
}

Retrieve Call Analytics

Retrieve call analytics based on filters provided in query parameters.

GET /integrations/call-analytics/

Headers

Name	Value
Authorization	Bearer Access Token

Query Parameters

Name	Type	Required	Description
date_end	string	Yes	End date in YYYY-MM-DD
date_start	string	Yes	Start date in YYYY-MM-DD
users	string	No	List of user emails

Response

{
 "data": [
  {
   "user": "johndoe123@example.com",
   "total_calls": 1000,
   "answered_calls": 500,
   "total_minutes": 2500
  },
  {
   "user": "janedoe456@example.com",
   "total_calls": 500,
   "answered_calls": 250,
   "total_minutes": 1250
  }
 ]
}