Skip to content
Home/
REST API Reference
/
/
Conversation Scorecard

Conversation Scorecard

A QA scorecard result for this conversation. Returned in the scorecards array on conversation responses when include_scorecards=true is passed.

scorecard_idstring

The unique identifier of the scorecard definition.

Example:"67890"
scorecard_version_idstring

The unique identifier of the specific scorecard version that produced this result.

Example:"67891"
namestring

The name of the scorecard.

Example:"Standard QA Review"
scorecard_typestring

The type of scorecard.

Example:"human"
passedboolean or null

Whether the conversation passed the scorecard. Null when the scorecard has not been scored.

Example:true
scorenumber or null

The numeric score for the scorecard. Null when the scorecard has not been scored.

Example:0.85
ai_scorenumber or null

The numeric score produced by AI evaluation, if applicable. Null when not AI-scored.

Example:0.9
evaluated_atinteger or null, (date-time)

The time the scorecard was last evaluated. Null in the rare case the underlying record's timestamp is not yet set.

Example:1719493065
reviewed_teammateobject(Reviewed Teammate)

The teammate (or AI agent) whose handling of the conversation was reviewed by this scorecard.

evaluatorsArray of objects(Conversation Scorecard Evaluator)

Per-evaluator results within this scorecard.

{
  "scorecard_id": "67890",
  "scorecard_version_id": "67891",
  "name": "Standard QA Review",
  "scorecard_type": "human",
  "passed": true,
  "score": 0.85,
  "ai_score": 0.9,
  "evaluated_at": 1719493065,
  "reviewed_teammate": {
    "type": "admin",
    "admin_id": "991267715"
  },
  "evaluators": [
    { … }
  ]
}