Docs Candidate Profiles Display candidate summary and actions

Display candidate summary and actions

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.

Before you begin

Ensure that you have reviewed the initial setup for Candidate Profiles.Review the contexts in which your software will surface SEEK Pass & SEEK Profile functionality. Generally, there are two:

Candidate or applicant list
Candidate details

Candidate or applicant list

Conditionally display SEEK Pass and SEEK Profile elements against each candidate in the list. The seekCandidateSummaries query lets you determine whether a given candidate has SEEK Pass verification and/or a SEEK Profile.

Retrieve summaries

Execute the seekCandidateSummaries query once per page of candidates, not once per candidate.

QueryVariablesResult

CopyGraphQL Explorer

query ($input: [SeekCandidateSummaryInput!]!) {

  seekCandidateSummaries(input: $input) {

    seekPrimaryEmailAddress

    seekProfile {

      exists

    identity {

      formattedName

      isVerified

Render profile link

Use the response from the seekCandidateSummaries query to determine whether to show a profile link for each candidate:

If seekProfile.exists is true, render a link to the Candidate Profile Panel
If seekProfile.exists is false, do not render the link

A text link may be used to represent the profile link:

Barista (Part-time)

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

Alternatively, you may represent the SEEK Profile with an icon button.SEEK will supply this icon asset when you begin your build. Your software must not modify it.

Barista (Part-time)

Render verification result

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 true, do not render the verification result

Identity verification must conform to our display requirements:

Render the SEEK Pass badge to denote the verification resultSEEK will supply this badge asset when you begin your build. Your 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.

Barista (Part-time)

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

Candidate details

Unconditionally display a link to the Candidate Profile Panel with prominent placement in the view. For example, a tabbed view may include a dedicated SEEK Profile tab.

Rachel Green

The Candidate Profile Panel will gracefully handle scenarios where the candidate does not have a SEEK Profile.

Candidate Profiles: Verify with SEEK Pass

Candidate Profiles: Display panel