Scout SelectDeveloper Documentation
Certifications

Badges

Check whether a candidate already holds a valid certification.

Requires the CERTIFICATION_RESULT_READ scope. Useful before creating an invite - a candidate can't be re-invited to a certification they already hold a currently-valid badge for (see Invites), so checking here first lets you skip straight to showing the existing credential instead of hitting a BAD_USER_INPUT error.

query CertificationBadges($email: String!) {
  developerCertificationBadges(email: $email) {
    validCandidate
    message
    badges {
      skillName
      level
      conceptsTested
    }
  }
}
  • validCandidate is false (with an explanatory message) if the email isn't a syntactically valid address, or no certification candidate exists for it yet - that's not an error, just an empty result.
  • badges only includes currently active, unexpired certifications - expired or revoked ones are omitted.

Example response

{
  "data": {
    "developerCertificationBadges": {
      "validCandidate": true,
      "message": null,
      "badges": [
        {
          "skillName": "React",
          "level": "Intermediate",
          "conceptsTested": ["Component state and effects", "Data fetching", "Debugging"]
        }
      ]
    }
  }
}

On this page