Scout SelectDeveloper Documentation
Assessments

Report Status

Check session and report status for one or more candidates.

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
  }
}
  • 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), or READY.
  • Passing assessmentSessionId returns at most one result. Passing candidateEmail or assessmentId alone can return up to 50 matching sessions, most recent first.