SEEK Developer

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.

Verify with SEEK Pass allows a hirer to request to verify a candidate. This is typically triggered when a candidate applies for a position.Identity verification can be requested for any candidate. It is not limited to candidates that have a SEEK Profile, nor to those that found the position on a SEEK job board.

Before you begin

Ensure that you have reviewed the initial setup for Candidate Profiles.

This feature will be available to Gold and Platinum partners only at launch, with support for additional credentials and wider partner availability planned in future.Don’t commence your build until you receive confirmation that we can support the certification and release of your integration. We’ll get in touch with remaining partners once Verify with SEEK Pass reaches general availability.

Hirer onboarding

The candidate verification flow can only be triggered for hirers that have onboarded to this feature. Hirers must have an established Verify with SEEK Pass relationship.Your software can keep track of configured relationships based on onboarding requests and/or subscribing to the 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.

Hirer opt out

Your software must provide a way for hirers to opt out of sending Verify with SEEK Pass requests to candidates. Verify with SEEK Pass is enabled by default for all hirers that have onboarded to this feature.To check whether Verify with SEEK Pass is enabled for a given hirer, use the hasVerifyWithSeekPassEnabled query:

QueryVariablesResult

CopyGraphQL Explorer

query ($input: HasVerifyWithSeekPassEnabledInput!) {

  hasVerifyWithSeekPassEnabled(input: $input) {

    enabled

When a hirer opts out of Verify with SEEK Pass, your software must trigger the toggleVerifyWithSeekPass mutation. Your software can re-enable Verify with SEEK Pass for a hirer at any time by triggering the same mutation with enabled set to true.

MutationVariablesResult

CopyGraphQL Explorer

mutation ($input: ToggleVerifyWithSeekPassInput!) {

  toggleVerifyWithSeekPass(input: $input) {

    hirerId

    enabled

Where this setting is placed depends on your software, though it is typically implemented as a checkbox on the hirer’s settings page.

Verify with SEEK Pass
Toggle this to control whether ID verification is shown against a candidate’s name and whether they receive ID verification request emails when they apply for a job

Trigger verification process

Use the verifyCandidate mutation to initiate the verification process with SEEK Pass.This mutation requires a partner token to be triggered from your software’s backend.Your software may automatically trigger verification for hirers when a job application is submitted, or manually, out of band of a job application process.Only trigger this mutation for hirers that meet both of the following requirements:

Have onboarded to Verify with SEEK Pass
Have enabled Verify with SEEK Pass

The metadata included in the query variables enables enhanced user support through the ID verification process.

MutationVariablesResult (to be verified)Result (already verified)

CopyGraphQL Explorer

mutation ($input: VerifyCandidateInput!) {

  verifyCandidate(input: $input) {

    verificationStatusCode

    ... on VerifyCandidatePayload_Pending {

      externalId

      redirectUri

      button {

        label

uri

        images {

          accent

          dark

          light

A successful response will contain a verificationStatusCode:

COMPLETE indicates that the candidate is already verified and has already consented to share their verification resultsNo further action is necessary.
PENDING indicates that the candidate has remaining actions to completeDisplay a Verify with SEEK Pass button and link the candidate to the redirectUri in order to complete their verification. This could be in an email, or on a job application submission page in your software.The button object provides:
- label: The localised button text (e.g., “Verify with SEEK Pass”)
- uri: The verification URL to navigate to when the button is clicked
- images: Three SVG button variants (accent, dark, light) for different backgrounds
If the verification process is triggered from the web, open the redirectUri in a new browser tab. It should be displayed after the candidate has submitted their application.

If you receive a FORBIDDEN error, your software may not have a Verify with SEEK Pass relationship with the hirer.

Display verify button

Display the Verify with SEEK Pass button to allow candidates to verify their identity. Generally this will be displayed on an email sent from your software, but you may also link to the verification page directly from a job application submission page in your software, a text message, or other channel.

You may use the recommended copy below in candidate emails, notifications, in-app messaging, and other channels. Ensure the button links the candidate to the redirectUri of the SEEK Pass identity verification flow.

Verify your identity for your application to {HIRER_NAME}

From: careers@hirer.exampleTo: candidate@mail.example

Hi {CANDIDATE_NAME},To strengthen your application for {ROLE_TITLE} at {HIRER_NAME} we are requesting that you verify your identity with SEEK Pass.

Optional copy for additional context on SEEK Pass

What 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.

Best regards,{HIRER_NAME} Careers TeamPartnering with SEEK Pass for secure identity verification.

Emails

Follow these guidelines when adding the Verify with SEEK Pass button to email communications:

Use PNG format for compatibility

PNG button assets provide the best support across email clients. Avoid using SVG or other formats that may not render consistently.

Set appropriate dimensions

The PNG buttons are exported at 2x resolution for rendering on high-resolution displays. Set the width attribute to half the original size of the exported button.

HTML

Copy

<!-- The exported button is 618px by 96px (@2x) -->

<img

  src="cid:vwsp-en-standard-accent.png"

  width="309"

  alt="Verify with SEEK Pass"

/>

Embed images inline

Many email clients block external images by default. To ensure your button displays immediately, attach the image as an inline resource using Content-ID (CID) embedding rather than linking to an external URL.This requires creating a multipart email with the image attached and referenced via the cid: scheme. The attachment should include these headers:

HTTP

Copy

Content-Type: image/png; name=vwsp-en-standard-accent.png

Content-ID: <vwsp-en-standard-accent.png>

Content-Transfer-Encoding: base64

Content-Disposition: inline; filename="vwsp-en-standard-accent.png"

<base64 image data>

Note: The Content-ID value (excluding angle brackets) must match the filename referenced in your src="cid:..." attribute.

Display verification result

To display verification results within a candidate or applicant list, follow the steps on the next page along with this guide, as both SEEK Profile and identity verification results should be retrieved from the same query.Use the response from the seekCandidateSummaries query to determine whether to show a verification result for each candidate:

If identity.isVerified is true, render the verification result
If identity.isVerified is false, do not render the verification result

Identity verification must conform to our display requirements:

Render the SEEK Pass badge to denote the verification resultYour software must not modify it.
Surface the formattedName alongside the badgeThis allows hiring managers to easily verify that the verification was performed on the correct candidate.

Design guidance

Display the SEEK Pass icon next to the candidate’s name. Retrieve the icon and its tooltip from the identity.icon field of the seekCandidateSummaries query.
Display a tooltip when hovering over the icon. If the response identity.icon.tooltipLabel cannot be used, the tooltip copy should be: Verified by SEEK Pass as {formattedName}.
Include a legend on your page with a badge that explains the meaning of the SEEK Pass icon.

Barista (Part-time)

Name	Source	Status
John Smith	SEEK	New
Sarah Johnson	Careers website	Shortlisted
Michael Brown	Other	Offered
Emma Wilson	SEEK	New
David Lee	Other	Shortlisted
Rachel Green	SEEK	New
James Taylor	Careers website	Shortlisted
Lisa Anderson	Other	Offered
Peter Wright	SEEK	New
Amy Chen	Careers website	Shortlisted

Legend:

Verified by SEEK Pass

Data retention

SEEK Pass verification results will be available to the requesting hirer for up to 180 days. The result will become unavailable if the candidate deletes their SEEK Pass account.Verification results may be available beyond 180 days, and to other hirers, for candidates that consent to share results to their public SEEK Profile.

Assets

SEEK provides a bundle of Verify with SEEK Pass button assets, including pre-approved buttons, text, and logo assets. You can always find the latest version below.

Use PNG buttons in emailsUse a PNG button asset in emails as SVGs may not render consistently or at all in certain email clients.

Button assets

Last updated: 2026-01-20

Use cases: Candidate Profiles

Candidate Profiles: Display candidate summary and actions