SparkTG

Agent performance report (v2) Documentation

Agent performance report (v2)

v2

Agent performance report (v2)

Per-agent call counts and talk, handle, hold and pickup times

API v2v21 Endpoint

Overview

Billable: this API is charged based on the number of records returned. Contact your account manager for pricing details. Per-agent performance metrics for the window: inbound and outbound call counts, answered counts, talk times, and handle, hold and pickup times. Returns an array with one row per agent, identified by agent_sip. Every metric value is returned as a string; talk, handle, hold and pickup times are in seconds.

Available Endpoints

POST/api/v2/reports/agent-performance

Key Parameters

svc_id(Integer)

Service to report on. Defaults to the token's service.

start_time(Integer (epoch ms))

Window start.

end_time(Integer (epoch ms))

Window end.

agent_sip(String)

Filter by agent SIP/extension, or a comma-separated list. Omit or leave empty for all agents.

Quick Example

Try this API with a simple cURL command

Basic API Call
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/agent-performance' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1776277800000, "end_time": 1776364200000, "agent_sip": ""}'
💡 Replace <YOUR_TOKEN> with your API token

Response Preview

Sample response from this API

Sample Response
[{"agent_name":"Ravi Kumar","agent_sip":"1042","ib_calls":"98","ib_answer":"50","ib_missed":"48","ib_tt":"617","ob_calls":"41","ob_answer":"28","ob_customer_answer":"24","ob_missed":"0","ob_tt":"1087"...
View complete response format in Response section