Calls Retrieval API

Live

v1.0

Retrieve call information including scheduled, completed, and in-progress calls. Query by agent, status, date range, and more with powerful filtering options.

Quick Reference

Endpoint

GET /api/voice-agents/calls

Authentication

Bearer nvb_your_api_key

Required Permission

Read access

Rate Limit

100 requests/minute

Call Data Sources

The API queries multiple data sources to provide comprehensive call information

Scheduled Calls

Calls that are planned but haven't started yet

Status: scheduled, cancelled

Collection: scheduledCalls

Completed Calls

Calls that have been executed with full details

Status: completed, failed, in_progress

Collection: calls

The API automatically searches both collections and merges results with proper deduplication based on call type.

Use Cases

📊 Analytics & Reporting

Retrieve call history for performance analytics, success rates, and business insights.

🔍 Agent Performance Monitoring

Filter calls by specific agents to monitor performance and optimize configurations.

📅 Campaign Tracking

Track scheduled calls and their outcomes for marketing campaigns and follow-up automation.

🚨 Real-time Status Updates

Check call status for integration with CRM systems and customer dashboards.

Need Help?

Get support from our developer team

Generate API Key Schedule Call API Contact Support Developer Email