Skip to main content
GET
/
v1
/
stats
/
basic
Retrieve aggregate statistics for analyzed calls
curl --request GET \
  --url https://api.example.com/v1/stats/basic \
  --header 'Authorization: Bearer <token>'
{
  "total_requests": 1250,
  "avg_score": 82.5,
  "min_score": 45,
  "max_score": 98,
  "avg_duration": "00:05:23",
  "min_duration": "00:01:15",
  "max_duration": "00:25:47",
  "total_agents": 45,
  "count_by_status": {
    "COMPLETED": 1200,
    "PROCESSING": 30,
    "FAILED": 20
  },
  "extracted_variables": [
    "greeting_quality",
    "resolution_achieved",
    "customer_satisfaction"
  ],
  "score_by_category": [
    {
      "category": "Opening",
      "avg_score": 88.5
    },
    {
      "category": "Resolution",
      "avg_score": 79.2
    }
  ],
  "agent_stats": [
    {
      "agent_id": "AGT-001",
      "agent_name": "John Smith",
      "call_count": 150,
      "avg_score": 85.2
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
start_date
string<date-time>
required

Start of date range (UTC)

​
end_date
string<date-time>
required

End of date range (UTC)

​
model_name
string
required

Name of the analysis model to filter by

Response

Successful Response

Aggregate statistics for analyzed calls within a date range

​
total_requests
integer
required

Total number of analyzed calls in the period

Example:

1250

​
avg_score
number

Average Neurascore percentage across all calls

Example:

82.5

​
min_score
number

Lowest Neurascore percentage

Example:

45

​
max_score
number

Highest Neurascore percentage

Example:

98

​
avg_duration
string

Average call duration (HH:MM:SS)

Example:

"00:05:23"

​
min_duration
string

Shortest call duration

Example:

"00:01:15"

​
max_duration
string

Longest call duration

Example:

"00:25:47"

​
total_agents
integer

Number of unique agents in the period

Example:

45

​
count_by_status
Count By Status · object

Breakdown of calls by processing status

Example:
{
  "COMPLETED": 1200,
  "PROCESSING": 30,
  "FAILED": 20
}
​
extracted_variables
string[]

List of available extracted variable keys

Example:
[
  "greeting_quality",
  "resolution_achieved",
  "customer_satisfaction"
]
​
score_by_category
Score By Category · object[]

Average scores broken down by evaluation category

Example:
[
  { "category": "Opening", "avg_score": 88.5 },
  {
    "category": "Resolution",
    "avg_score": 79.2
  }
]
​
agent_stats
Agent Stats · object[]

Per-agent performance statistics

Example:
[
  {
    "agent_id": "AGT-001",
    "agent_name": "John Smith",
    "call_count": 150,
    "avg_score": 85.2
  }
]