Skip to content

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
Calls the AI disagreed with
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…"
}

Questions it answers

One request each

Which sales did the AI not hear as a sale?

GET /calls?dialer_disposition=SALE&disposition_match=false

Which agents mis-code the most calls?

GET /performance?group_by=agent&sort=ai_disposition_mismatch_rate

Who is top of the leaderboard this month?

GET /performance?group_by=agent&sort=avg_score&min_scored=20

Who fails the recording disclosure most?

GET /performance/rules?rule_key=C001&group_by=agent

How do dialer and AI dispositions compare?

GET /performance/disposition-accuracy?mismatches_only=true

What happened on every call for this lead?

GET /calls?dialer_lead_id=4417520

How it works

From key to dashboard in an afternoon

  1. 1

    Get a key

    An Esper QA admin creates an API key with only the permissions your system needs.

  2. 2

    Ask a question

    Plain HTTPS GET requests with the key in an X-API-Key header. JSON back, cursors for paging.

  3. 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.