v1
latestOpenAPI 3.0.02026-07-2633090.6 KBcalling
Get Call History
Retrieves the history of calls made through the Ringg AI platform with optional filtering and pagination.
get/calling/history
Query parameters
start_datestring date-time
Example:2025-09-25T00:00:00+05:30
Filter calls starting from this date (ISO 8601 format with timezone).
end_datestring date-time
Example:2025-09-25T23:59:59+05:30
Filter calls up to this date (ISO 8601 format with timezone).
limitinteger
Example:50
Maximum number of calls to return (default: 10).
offsetinteger
Example:20
Number of calls to skip (default: 0).
agent_idstring
Example:830f767a-397e-4b39-82ff-235cd344e2f9
Filter calls by assistant ID.
status'registered' | 'ongoing' | 'retry' | 'error' | 'completed' | 'failed' | 'cancelled' | 'forwarded'
Example:completed
Filter calls by status.
bulk_list_idstring
Example:123e4567-e89b-12d3-a456-426614174000
Filter calls by bulk list ID.
Headers
X-API-KEYstring required
Example:7251cb4b-3373-43a4-844c-b27a1d45e0c9
(Required) Your Ringg AI API key.
Response
Successful Response: Call history. Response format depends on download_format parameter.