Skip to main content

​
Overview

A score card template defines the scoring rubric (topics, weights, and rubric descriptions) used to evaluate candidates for an interview. Each interview has at most one active template. Templates are addressed under their interview: 
/qsi/gather/interviews/{interviewId}/score-card-template
Topic weight is provided as a number from 0 to 100. You can also create a scorecard inline when creating an interview via the scoreCardTopics field on POST /interviews.

​
Get Score Card Template

Endpoint: GET /qsi/gather/interviews/{interviewId}/score-card-template
​
interviewId
string
required
UUID of the interview.
{
  "data": {
    "scoreCardTemplate": {
      "id": "template-uuid",
      "interviewId": "interview-uuid",
      "topics": [
        {
          "topic": "System Design",
          "weight": 60,
          "description": "Evaluate system design ability",
          "lookingFor": ["Scalability", "Trade-off analysis"],
          "scoreDescriptions": {
            "level1": "Limited",
            "level3": "Adequate",
            "level5": "Exceptional"
          }
        }
      ],
      "version": 1,
      "isActive": true,
      "createdAt": "2026-01-15T00:00:00Z",
      "updatedAt": "2026-01-15T00:00:00Z"
    }
  },
  "meta": { "requestId": "req-uuid", "timestamp": "2026-01-15T00:00:00Z" }
}

​
Create Score Card Template

Endpoint: POST /qsi/gather/interviews/{interviewId}/score-card-template
​
interviewId
string
required
UUID of the interview.
curl -X POST \
  https://api.prod.qualifi.hr/qsi/gather/interviews/{interviewId}/score-card-template \
  -H "x-api-key: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "topics": [
      {
        "topic": "System Design",
        "weight": 60,
        "lookingFor": ["Scalability"],
        "scoreDescriptions": {
          "level1": "Limited",
          "level3": "Adequate",
          "level5": "Exceptional"
        }
      }
    ]
  }'

​
Update Score Card Template

Endpoint: PATCH /qsi/gather/interviews/{interviewId}/score-card-template
​
interviewId
string
required
UUID of the interview.

​
Delete Score Card Template

Endpoint: DELETE /qsi/gather/interviews/{interviewId}/score-card-template
​
interviewId
string
required
UUID of the interview.

​
Generate Score Card Template

Generate a suggested scorecard for the interview from its questions and job description. Endpoint: POST /qsi/gather/interviews/{interviewId}/score-card-template/generate
​
interviewId
string
required
UUID of the interview.

​
Suggest Topics

Suggest scorecard topics without persisting them. Endpoint: POST /qsi/gather/score-card-templates/suggest-topics
This endpoint is not interview-scoped — it returns suggested topics you can review and then submit via Create or Update.

Interviews

Create interviews and attach scorecards inline

Replicas

Avatars for AI interviewers