Scout SelectDeveloper Documentation
Certifications

Results

Fetch the current status and outcome of a certification invite.

Requires the CERTIFICATION_RESULT_READ scope.

query CertificationResult($inviteId: String!) {
  developerCertificationResult(inviteId: $inviteId) {
    inviteId
    status
    skillName
    level
    completedAt
    resultBand
    score
    proctoringStatus
    resultReleaseStatus
    certificateUrl
    verificationStatus
    feedbackAreas
    reportUrl
    skillWiseScores {
      label
      score
      concepts {
        label
        score
      }
    }
    communicationScores {
      label
      score
    }
    badgeImageUrl
  }
}

Status fields

  • status progresses through PENDING -> ACTIVE -> COMPLETED -> EXPIRED.
  • proctoringStatus is separate from status: PENDING (not yet reviewed), PENDING_REVIEW (flagged, awaiting manual review), CLEARED, or CONFIRMED (cheating confirmed).
  • resultReleaseStatus tells you whether the candidate-facing result can be shown yet: PENDING, PENDING_REVIEW, or RELEASED.

While resultReleaseStatus is anything other than RELEASED, the result-bearing fields (resultBand, score, certificateUrl, verificationStatus, feedbackAreas, reportUrl, skillWiseScores, communicationScores, badgeImageUrl) are null - don't treat their absence as an error, it means review is still pending.

Result fields

  • skillWiseScores / communicationScores - populated whenever the attempt has a full narrative report (the common case); null for quiz-only attempts that never generated one.
  • badgeImageUrl - the URL of the badge image for the achieved level (see Badges), only set when resultBand is EXCELLENT or GOOD (i.e. a certificate was actually issued).

Example request

curl https://select.getscout.ai/api/developer/graphql \
  -H "x-api-key: sk_scout_..." \
  -H "content-type: application/json" \
  -d '{
    "query": "query CertificationResult($inviteId: String!) { developerCertificationResult(inviteId: $inviteId) { inviteId status skillName level completedAt resultBand score proctoringStatus resultReleaseStatus certificateUrl verificationStatus feedbackAreas reportUrl } }",
    "variables": { "inviteId": "clv2x..." }
  }'

Example response (released)

{
  "data": {
    "developerCertificationResult": {
      "inviteId": "clv2x...",
      "status": "COMPLETED",
      "skillName": "React",
      "level": "Intermediate",
      "completedAt": "2026-07-20T09:41:00.000Z",
      "resultBand": "GOOD",
      "score": 78,
      "proctoringStatus": "CLEARED",
      "resultReleaseStatus": "RELEASED",
      "certificateUrl": "https://select.getscout.ai/certifications/verify/abc123",
      "verificationStatus": "ISSUED",
      "feedbackAreas": ["Error handling", "Debugging"],
      "reportUrl": "https://select.getscout.ai/reports/9f3a1c...",
      "skillWiseScores": [
        { "label": "React", "score": 7.5, "concepts": [{ "label": "Hooks", "score": 8 }] }
      ],
      "communicationScores": [
        { "label": "Communication", "score": 7 }
      ],
      "badgeImageUrl": "https://scout-interview.sgp1.cdn.digitaloceanspaces.com/certifications/public/intermediate-badge.png"
    }
  }
}

On this page