Skip to main content
GET
/
analytics
/
duration-distribution
Get Duration Distribution
curl --request GET \
  --url https://prod-api.ringg.ai/ca/api/v0/analytics/duration-distribution \
  --header 'X-API-KEY: <x-api-key>'
{
  "duration_distribution": {}
}
Return call duration distribution analytics. Use this to understand whether conversations are too short, too long, or clustered around expected script lengths.

​
Use this for

  • Detecting early hangups or low engagement.
  • Spotting calls that exceed the expected script length.
  • Tuning assistant prompts, transfer rules, and max call length.
Filter by agent_id or bulk_list_id when investigating one assistant or campaign. For campaign dashboards, combine this distribution with classification analytics so teams can see whether short calls are failed attempts, successful quick confirmations, or early hangups.

Headers

​
X-API-KEY
string
required

(Required) Your Ringg AI API key.

Example:

"7251cb4b-3373-43a4-844c-b27a1d45e0c9"

Query Parameters

​
start_date
string
default:2025-09-25

Start date for analytics filter (YYYY-MM-DD format)

Example:

"2025-09-25"

​
end_date
string
default:2025-09-25

End date for analytics filter (YYYY-MM-DD format)

Example:

"2025-09-25"

​
agent_id
string

Filter by specific agent ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
bulk_list_id
string

Filter by specific bulk list/campaign ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
voicemail
boolean

Filter by voicemail status

Example:

false

Response

Duration distribution retrieved successfully.

​
duration_distribution
object

Call duration distribution data