Skip to main content
POST
/
analytics-evaluator
Evaluator Analysis
curl --request POST \
  --url https://api.heify.com/analytics-evaluator \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "evaluator_id": "2abb5563-dd64-47bb-bb17-94252e168b06"
}
'
{
  "data": {
    "metadata": {
      "total_records_analyzed": 6,
      "query_limit_reached": false,
      "generated_at": "2026-03-22T01:08:17.482723"
    },
    "kpis": {
      "total_calls": 6,
      "avg_score": 53.1,
      "pass_rate": 83.3,
      "total_critical_fails": 0,
      "pending_critical_reviews": 0
    },
    "charts": {
      "timeline": [
        {
          "date": "2026-03-07",
          "avg_score": 53.3,
          "volume": 3,
          "critical_fails": 0
        },
        {
          "date": "2026-03-12",
          "avg_score": 52.8,
          "volume": 1,
          "critical_fails": 0
        }
      ],
      "heatmap": {
        "saturday": {
          "12": 52.8,
          "22": 53.3
        },
        "thursday": {
          "20": 52.8
        }
      }
    },
    "participants": [
      {
        "id": "580cc0e1-3a60-49d9-8e20-1745252f0aae",
        "tag": "Pedro Borrado",
        "calls": 4,
        "avg_score": 53.2,
        "critical_fails": 0,
        "critical_fail_rate": 0,
        "consistency": 13.13,
        "avg_duration": 587
      }
    ],
    "criteria_breakdown": [
      {
        "id": "2faa4a20-7445-4beb-a09e-2af26872dba3",
        "name": "Saludo Corporativo inicial2",
        "fail_count": 6,
        "fail_rate": 100
      }
    ],
    "score_distribution": {
      "0-20": 0,
      "21-40": 1,
      "41-60": 4,
      "61-80": 1,
      "81-100": 0
    },
    "comparison": {
      "current_period": {
        "calls": 6,
        "avg_score": 53.1,
        "pass_rate": 83.3
      },
      "previous_period": {
        "calls": 0,
        "avg_score": 0,
        "pass_rate": 0
      },
      "delta": {}
    },
    "duration_insights": {
      "thresholds": {
        "p25": 543,
        "p75": 602
      },
      "short": {
        "count": 3,
        "avg_score": 52.8
      },
      "medium": {
        "count": 1,
        "avg_score": 65
      },
      "long": {
        "count": 2,
        "avg_score": 47.5
      }
    },
    "raw_data": [
      {
        "id": "e927a34c-8f2f-4045-8a15-c0f7a182bab2",
        "date": "2026-03-12T20:33:14.145386+00:00",
        "score": 52.8,
        "critical": false,
        "duration": 542,
        "participant_tag": "Pedro Borrado",
        "participant_id": "580cc0e1-3a60-49d9-8e20-1745252f0aae",
        "group": null,
        "status": "COMPLETED",
        "failed_criteria": [
          "Saludo Corporativo inicial2"
        ]
      },
      {
        "id": "67ff08bf-c1e5-441d-a8ba-c9909254ed1d",
        "date": "2026-03-07T22:54:33.882702+00:00",
        "score": 65,
        "critical": false,
        "duration": 578,
        "participant_tag": "Pedro Borrado",
        "participant_id": "580cc0e1-3a60-49d9-8e20-1745252f0aae",
        "group": null,
        "status": "COMPLETED",
        "failed_criteria": [
          "Saludo Corporativo inicial2"
        ]
      }
    ]
  }
}
This endpoint counts against your monthly analytics quota. Each call is counted even if no data is returned. Returns 429 when the limit is reached. See Rate Limits & Quotas.
Only COMPLETED transcriptions with a non-null evaluation score are included. IN_PROGRESS and FAILED transcriptions are excluded.
Results are capped at 20,000 transcriptions. If data.metadata.query_limit_reached is true, the report is based on a partial dataset.
Use data.charts.heatmap to identify which days and hours show the lowest performance — useful for targeting training or adjusting scheduling.
data.comparison.delta may be an empty object {} when either the current or previous period has no calls.
data.criteria_breakdown only includes criteria that still exist on the evaluator. Deleted criteria are excluded.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
evaluator_id
string<uuid>
required

The evaluator to analyze. Must belong to the authenticated account.

Response

200 - application/json

Analysis generated successfully.

​
data
object