Report Status

Requires GET_REPORT_STATUS. Pass exactly one of assessmentSessionId, candidateEmail, or assessmentId to scope the lookup (mixing them narrows the query further, but you'll usually only need one).

query DeveloperReportStatus($assessmentSessionId: String, $candidateEmail: String, $assessmentId: String) {
  developerReportStatus(
    assessmentSessionId: $assessmentSessionId
    candidateEmail: $candidateEmail
    assessmentId: $assessmentId
  ) {
    assessmentSessionId
    status
    candidateId
    candidateName
    candidateEmail
    assessmentId
    assessmentTitle
    reportId
    reportStatus
    dashboardReportUrl
    interviewUrl
    result {
      assessmentSessionId
      overallScore
      skillWiseScores {
        label
        score
        concepts {
          label
          score
        }
      }
      communicationScores {
        label
        score
      }
    }
  }
}

• status is the session's own lifecycle: PENDING, ACTIVE, COMPLETED, or EXPIRED.
• reportStatus tells you whether the report itself is ready: NOT_READY (session not complete yet), PROCESSING (interview finished, report still generating), READY, or FAILED (report generation errored - won't resolve on its own, contact support if you see this).
• result is null until reportStatus is READY. It has the exact same shape as the assessment.completed webhook's result field:
  • overallScore - 1-10.
  • skillWiseScores - per-skill score (1-10) with a nested concepts breakdown (0-10, derived from the candidate's demonstrated proficiency tier per concept). Only the label and score are exposed, not the underlying analysis.
  • communicationScores - 7 dimensions (Communication, Sentiment, Clarity, Conciseness, Fluency, Confidence, Consistency), each 1-10.
• Passing assessmentSessionId returns at most one result. Passing candidateEmail or assessmentId alone can return up to 50 matching sessions, most recent first.