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
}
}Status fields
statusprogresses throughPENDING->ACTIVE->COMPLETED->EXPIRED.proctoringStatusis separate fromstatus:PENDING(not yet reviewed),PENDING_REVIEW(flagged, awaiting manual review),CLEARED, orCONFIRMED(cheating confirmed).resultReleaseStatustells you whether the candidate-facing result can be shown yet:PENDING,PENDING_REVIEW, orRELEASED.
While resultReleaseStatus is anything other than RELEASED, the result-bearing fields
(resultBand, score, certificateUrl, verificationStatus, feedbackAreas, reportUrl) are null -
don't treat their absence as an error, it means review is still pending.
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..."
}
}
}