Skip to main content

​
When to use this

Use this query after an interview is completed to retrieve each question (step), its answers (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

  • steps (union) — fetches each interview question. Use __typename to branch your UI:
    • InterviewStepTextQuestionWithVideoAnswer : Text-based question
    • InterviewStepVideoQuestionWithVideoAnswer : Video-based question
  • scores — overall reviewer scores with the scorer’s name. You can drop this attribute if you only want to retrieve the video transcription or URL.
  • answers(input: ) — the submitted answers for the different questions.
  • video.transcription — language code & full text of the spoken answer.
  • video.meta.duration — the length of each video response in seconds.
  • 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.

​
Example Response

{
  "data": {
    "interview": {
      "id": "68d4164f19367e041b2030c0",
      "steps": [
        {
          "__typename": "InterviewStepVideoQuestionWithVideoAnswer",
          "id": "68d4164f19367e041b2030c1",
          "title": "Motivation",
          "description": "What's your motivation for joining company XYZ?",
          "scores": [
            { "value": 2.5, "scorer": { "name": "Michiel" } }
          ],
          "answers": [
            {
              "id": "68d5535890055f43302658a4",
              "video": {
                "transcription": {
                  "languageCode": "en",
                  "text": "I 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.