Get Number Analytics
curl --request GET \
--url https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics \
--header 'X-API-KEY: <api-key>'import requests
url = "https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"number_analytics": "<array>"
}{
"message": "Invalid credentials"
}{
"message": "An unexpected error occurred. Please try again later."
}Get Number Analytics
Get call metrics grouped by caller number to compare how each of your numbers performs, filtered by date range, agent, campaign or voicemail status.
GET
/
analytics
/
number-analytics
Get Number Analytics
curl --request GET \
--url https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics \
--header 'X-API-KEY: <api-key>'import requests
url = "https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://prod-api.ringg.ai/ca/api/v0/analytics/number-analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"number_analytics": "<array>"
}{
"message": "Invalid credentials"
}{
"message": "An unexpected error occurred. Please try again later."
}Use it to find a number that connects less often than the others. Phone numbers covers spam-flagged numbers, and a number pool can rotate past them.
Authorizations
Headers
(Required) Your Ringg AI API key.
Example:
"rg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Query Parameters
Start date for analytics filter (YYYY-MM-DD format)
Example:
"2025-09-25"
End date for analytics filter (YYYY-MM-DD format)
Example:
"2025-09-25"
Filter by specific agent ID
Example:
"123e4567-e89b-12d3-a456-426614174000"
Filter by specific bulk list/campaign ID
Example:
"123e4567-e89b-12d3-a456-426614174000"
Filter by voicemail status
Example:
false
Response
Number analytics retrieved successfully.
Analytics data grouped by phone numbers
Was this page helpful?