How-to: Fetching Interview Results

When to use this

Use this query after an interview is completed to retrieve each question’s execution (stepExecutions), its latest answer (video URL, transcript, & duration), and any reviewer scores for the interview. You can use this information to display or play recordings directly in your own system.

GraphQL Request

Use this query to retrieve the answers for a specific interview. Make sure to replace the ID value with the interview ID you want to fetch (see how to find interviews for a position). Don’t forget to update the Hireflix API Key in the headers.

Explanation

• stepExecutions (union) — fetches the execution of each interview question. Use ... on AdminInterviewStepQAExecution to access the fields below; the fragment covers both text- and video-based questions, so you no longer need to branch on __typename per question type.
• status — the current state of the step execution (e.g. COMPLETED).
• scores — overall reviewer scores. scorer now returns email, name, and lastname. You can drop this attribute if you only want to retrieve the video transcription or URL.
• latestAnswer — the most recent submitted answer for the question (replaces the old answers(input:) list).
• recordedAttempts — the number of times the candidate re-recorded their answer before submitting.
• submittedAt — the timestamp the answer was submitted.
• video.transcription — language code, full text, and vttSubtitles of the spoken answer. This is null for very short answers or when transcription isn’t available.
• video.durationInSeconds — the length of the video response in seconds (replaces the old meta.duration).
• video.url — returns a signed link you can use to playback interview answers.

The API returns signed URLs for video playback. These URLs expire after 14 days to protect privacy and prevent leaks. Do not store these URLs in your database. Instead, fetch fresh URLs whenever you need to play a video. They’re cached server-side for speed, so fetching is quick. You can display these videos directly in your system using an HTML <video> tag.

This query replaces the deprecated steps(input:) field and its InterviewStepTextQuestionWithVideoAnswer / InterviewStepVideoQuestionWithVideoAnswer types. If you’re migrating from the old schema, see the mapping below.

Example Response

{
  "data": {
    "interview": {
      "id": "68ff63a714e4aab6ada84854",
      "stepExecutions": [
        {
          "id": "68ff63a714e4aab6ada84855",
          "finishedAt": "2025-10-27T12:22:10.542Z",
          "scores": [
            { "value": 2.5, "scorer": { "email": "[e-mail]", "name": "Michiel", "lastname": "" } }
          ],
          "status": "COMPLETED",
          "latestAnswer": {
            "recordedAttempts": 0,
            "submittedAt": "2025-10-27T12:22:10.542Z",
            "video": {
              "durationInSeconds": 2.02,
              "transcription": {
                "languageCode": "en",
                "text": "I love working at this company.",
                "vttSubtitles": "WEBVTT\n\n00:00:00.000 --> 00:00:02.020\nI love working at this company."
              },
              "url": "https://media.hireflix.com/...mp4?Policy=...&Key-Pair-Id=...&Signature=..."
            }
          }
        }
      ]
    }
  }
}

Learn next?

Let’s learn how to score and comments interviews.