This content provides an early look at an upcoming extension to the SEEK API. You may use it to scope integration effort, but the features described are not fully implemented and may be adjusted ahead of a production release.Check with your SEEK contact before starting any build work described here.
HirerRelationshipChanged event.
The Developer Dashboard hirers page displays the SEEK hirers that you have a relationship with and lets you check whether they have the required CandidateVerification relationship.
Alternatively, the hiringOrganization query enables your software to retrieve the relationships on demand.Your software must provide a way for hirers to opt out of sending Verify with SEEK Pass requests to candidates.Where this setting is placed depends on your software, though it is typically implemented as a checkbox on the hirer’s settings page:This will prevent ID Verification emails from being sent to candidates when they apply for a job.
verifyCandidate mutation to initiate the verification process with SEEK Pass.Your software may automatically trigger verification for opted-in hirers when a job application is submitted,
or manually,
out of band of a job application process.MutationVariablesResult (to be verified)Result (already verified)
CopyGraphQL Explorer
mutation ($input: VerifyCandidateInput!) {
verifyCandidate(input: $input) {
verificationStatusCode
... on VerifyCandidatePayload_Verify {
externalId
redirectUri
button {
label
uri
}
}
}
}verificationStatusCode:Completeindicates that the candidate is already verified and has already consented to share their verification resultsNo further action is necessary.Pendingindicates that the candidate has remaining actions to completeDisplay a Verify with SEEK Pass button and link the candidate to theredirectUriin order to complete their verification. This could be in an email, or on a job application submission page in your software.
FORBIDDEN error,
your software may not have a Verify with SEEK Pass relationship with the hirer.Contact us if your software requires operations to verify candidates in
bulk.
redirectUri of the SEEK Pass identity verification flow.Verify your identity for your application to {HIRER_NAME}
From: careers@hirer.exampleTo: candidate@mail.exampleHi {CANDIDATE_NAME},To strengthen your application for {ROLE_TITLE} at {HIRER_NAME} we are requesting that you verify your identity with SEEK Pass.Best regards,{HIRER_NAME} Careers TeamPartnering with SEEK Pass for secure identity verification.
Optional copy for additional context on SEEK PassWhat is SEEK Pass?SEEK Pass is a secure digital passport to verify and share work credentials. It has verified millions of candidate credentials.Employers request credential verification to identify quality candidates and shortlist faster. SEEK Pass ensures your privacy by sharing verification results, not documents.
Contact us if your software requires webhook notifications for verification
results.