Get Interview Results | Gradii API Documentation

curl -X POST https://gradii.ai/api/v2/interviews/results \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "interviewId": "interview_abc123_candidateId_1234567890"
}'

{
  "interview": {
    "id": "db-id-123",
    "interviewId": "interview_abc123_candidateId_1234567890",
    "type": "behavioral",
    "title": "Technical Round",
    "candidateName": "John Doe",
    "candidateEmail": "john@example.com",
    "status": "completed",
    "completedAt": "2024-02-15T11:30:00.000Z",
    "startedAt": "2024-02-15T10:00:00.000Z",
    "duration": 5400,
    "difficultyLevel": "medium",
    "sourceType": "direct"
  },
  "questions": [
    {
      "id": "q1",
      "question": "Describe a challenging project you worked on",
      "type": "behavioral",
      "difficulty": "Medium",
      "category": "Technical",
      "tags": "problem-solving, teamwork"
    }
  ],
  "answers": [
    {
      "questionId": "q1",
      "userAnswer": "I worked on a microservices migration project...",
      "isCorrect": true,
      "score": 4.5,
      "maxScore": 5,
      "timeSpent": 180,
      "type": "behavioral",
      "difficulty": "Medium",
      "question": "Describe a challenging project you worked on",
      "id": "q1",
      "correctAnswer": "",
      "expectedAnswer": ""
    }
  ],
  "summary": {
    "totalQuestions": 5,
    "totalAnswered": 5,
    "score": 22.5,
    "maxScore": 25,
    "percentage": 90,
    "completionRate": 100,
    "averageTimePerQuestion": 180,
    "totalTimeSpent": 900,
    "performanceLevel": "excellent"
  },
  "analytics": {
    "questionTypeBreakdown": {
      "coding": 0,
      "mcq": 0,
      "behavioral": 5
    },
    "correctAnswers": 5,
    "incorrectAnswers": 0,
    "averageScore": 4.5,
    "timeEfficiency": "excellent",
    "strengths": [
      "Demonstrates ability to respond to questions with relevant examples",
      "Shows consistent engagement throughout the interview process"
    ],
    "improvements": [
      "Could provide more specific details and context in responses"
    ],
    "recommendations": [
      "Consider preparing more structured examples using the STAR method"
    ],
    "overallAssessment": "The candidate demonstrated excellent performance...",
    "mcqAccuracy": 0,
    "codingScore": 0
  },
  "candidate": {
    "id": "cand_789",
    "name": "John Doe",
    "email": "john@example.com"
  },
  "videoRecordings": {
    "hasRecordings": true,
    "fullInterview": "https://azure.blob.storage/interviews/video_abc123.mp4",
    "metadata": {
      "fileName": "interview-abc123.mp4",
      "fileSize": 52428800,
      "duration": 5400,
      "mimeType": "video/mp4"
    }
  }
}

Get complete interview results including questions, answers, scores, analytics, and video recordings

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

interviewIdstringOptional

Single interview ID (for single request)

interviewIdslist of anyOptional

Array of interview IDs (1-100, for bulk request)

Response

Single interview result retrieved

interviewobject

questionslist of objects

answerslist of objects

summaryobject

analyticsobject

candidateobject

videoRecordingsobject