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"
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.heify.com/llms.txt

Use this file to discover all available pages before exploring further.

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