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 SEEK Profile.

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 hiringOrganization query:

QueryVariablesResult with Verify with SEEK Pass enabledResult with Verify with SEEK Pass disabled

CopyGraphQL Explorer

query ($id: String!) {

  hiringOrganization(id: $id) {

id

    name

    seekApiCapabilities {

      # If the disabledFeatures array is empty, Verify with SEEK Pass is enabled.

      # If the disabledFeatures array contains the code "CandidateVerification", Verify with SEEK Pass is disabled.

      disabledFeatures

To change whether Verify with SEEK Pass is enabled for a hirer, use the setDisabledFeatures mutation. Pass the full list of feature codes you want disabled for that hirer; any feature not in the list remains enabled.

To disable Verify with SEEK Pass, include CandidateVerification in the disabledFeatures array.
To enable Verify with SEEK Pass, pass an empty array (or omit CandidateVerification from the list).

MutationVariablesResult

CopyGraphQL Explorer

mutation ($input: SetDisabledFeaturesInput!) {

  setDisabledFeatures(input: $input) {

    disabledFeatures

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

For hirers with multiple SEEK accounts, you must use the hiringOrganization query and setDisabledFeatures mutation (as documented above) for each of their SEEK accounts.

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 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 {COMPANY_NAME}

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

Hi {CANDIDATE_NAME},Thank you for applying for {ROLE} at {COMPANY_NAME} We're inviting you to verify your identity through SEEK Pass.It only takes a few minutes and adds a verified badge to your profile, helping us review it with greater confidence. While this step is optional, we encourage candidates to complete it as part of the application process.

Best regards,
The {COMPANY_NAME} Hiring Team

Required copy for additional context on SEEK Pass

What is SEEK Pass?SEEK Pass is a secure digital passport used to verify and share work credentials. It helps employers review applications with confidence while protecting your privacy by sharing verification results, not your documents.Visit www.seekpass.co to learn more.

Unsubscribe

Emails

Important requirements

The verification invitation must be presented as coming from the hirer, not from your software or from SEEK.
Use hirer branding (e.g. logo, colours) and send from a hirer-owned address such as careers@example.com.
Candidates should clearly recognise the email as a request from the employer they applied to.
Hirers must be able to customise the content of the verification email. Your software should support editable copy (e.g. greeting, body text, sign-off) so each hirer can tailor the message. The section that explains Verify with SEEK Pass and contains the verification button must remain fixed. Hirers cannot change or remove this block.
The verification email must include an unsubscribe option so candidates can opt out of future marketing or commercial emails from that hirer. This is required on a per-hirer basis: each hirer’s emails must offer a way for candidates to opt out of that hirer’s communications.
Candidates should be able to re-subscribe to verification invitations from a specific hirer through the individual’s settings page. Your software is expected to support per-hirer preferences so a candidate can opt back in to verification emails from a hirer they previously unsubscribed from.

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

Verification results remain available as long as the candidate permits based on their SEEK Profile privacy setting.The result will become unavailable if the candidate deletes their SEEK Pass account.Verification results may be available to other hirers for candidates that consent to share results to their public 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: SEEK Profile

SEEK Profile: Display candidate summary and actions