Esper QA Docs
Esper QA public API · v2
Every call your agents make, scored and searchable from your own systems.
Read-only access to calls with their dialer and AI dispositions, rule-by-rule QA results, transcripts, recordings and agent performance. One key, plain JSON.
- 23 endpoints
- Read-only, per-key permissions
- OpenAPI 3.1 description
GET /api/v2/calls?disposition_match=false &ended_from=2026-10-28T00:00:00Z&ended_to=2026-10-29T00:00:00Z X-API-Key: sqa_••••••••
{
"items": [{
"dialer_lead_id": "4417520",
"talk_time_seconds": 312,
"dialer_disposition": "SALE",
"ai_disposition": "NI",
"disposition_match": false,
"score": 64.5,
"quality_band": "FAIR",
"fatal_rule_keys": []
}],
"next_cursor": "WyIyMDI2LTEwLTI4…"
}What you can pull
The whole QA picture, not just a score
Calls and dispositions
Every call with the code the agent set on the dialer, the code the AI heard, and whether they agree.
GET /callsGET /calls/{id}GET /calls/changes
QA results
Score, quality band and every compliance and KPI rule, with the transcript quotes behind each result.
GET /calls/{id}/evaluationGET /calls/{id}/reviewGET /calls/{id}/transcript
Agent performance
Leaderboards, scorecards, team comparisons and daily trends, with rates already worked out correctly.
GET /performanceGET /performance/rulesGET /coaching-cases
Leads and sync
Look up a lead or phone, pull what the agent captured, and keep your CRM or warehouse current.
GET /calls?dialer_lead_id=…GET /leads/detailsGET /facts/days
Questions it answers
One request each
Which sales did the AI not hear as a sale?
GET /calls?dialer_disposition=SALE&disposition_match=falseWhich agents mis-code the most calls?
GET /performance?group_by=agent&sort=ai_disposition_mismatch_rateWho is top of the leaderboard this month?
GET /performance?group_by=agent&sort=avg_score&min_scored=20Who fails the recording disclosure most?
GET /performance/rules?rule_key=C001&group_by=agentHow do dialer and AI dispositions compare?
GET /performance/disposition-accuracy?mismatches_only=trueWhat happened on every call for this lead?
GET /calls?dialer_lead_id=4417520How it works
From key to dashboard in an afternoon
- 1
Get a key
An Esper QA admin creates an API key with only the permissions your system needs.
- 2
Ask a question
Plain HTTPS GET requests with the key in an X-API-Key header. JSON back, cursors for paging.
- 3
Stay in sync
Change feeds and day manifests keep your copy current without re-downloading everything.
Ready to connect?
Start with the getting-started guide, or try any endpoint live in the reference.