Exporting candidate profiles

Exporting candidate profiles

The SEEK API lets you retrieve information about a candidate and their profile related to a particular application.
When a candidate applies for a job ad they consent to a snapshot of their SEEK profile being shared with the hirer. SEEK recommends that any retrieved candidate information only be available for viewing under the job ad that the application was related to. If you decide to persist a general candidate profile in your software, it must be scoped to the SEEK hirer that received the application.

Before you begin

Before you start working with candidate profiles, you will need to request a partner token.

Data structure

The CandidateProfile object links to:
The candidate profile itself contains:
  • Structured details of the candidate’s work experience, education, and more.
    These fields are taken as a snapshot of the candidate’s SEEK profile when they apply through a supported channel. When a candidate applies to jobs posted via the deprecated Job Posting API they’ll be presented with a minimal set of fields prefilled from their SEEK profile.
  • Links to attachments such as the candidate’s resume and cover letter.
  • The candidate’s responses to the job’s screening questions via a seekQuestionnaireSubmission field. This will only be present if a questionnaire was provided when posting the job ad.
For detailed information on all available fields, refer to the CandidateProfile schema definition . Only a name and email address are required to create a SEEK candidate account; all other fields in a candidate’s profile are optional.

Operations

Use the GraphQL candidateProfile query to retrieve candidate profiles. You should combine this with the query you use to retrieve attachments and questionnaire submissions.

candidateProfile

QueryVariablesResult
query ($id: String!) {
  candidateProfile(id: $id) {
    profileId {
      value
    }
    createDateTime
    candidate {
      person {
        name {
          given
          family
        }
        communication {
          phone {
            formattedNumber
          }
          email {
            address
          }
        }
      }
    }
    associatedPositionProfile {
      seekHirerJobReference
      positionOrganizations {
        id {
          value
        }
        name
      }
      positionUri
    }
    employment {
      organization {
        name
      }
      positionHistories {
        start
        end
        title
      }
    }
    education {
      institution {
        name
      }
      educationDegrees {
        name
        degreeGrantedStatus
        date
      }
      descriptions
    }
    certifications {
      name
      issued
      effectiveTimePeriod {
        validTo
      }
      issuingAuthority {
        name
      }
      descriptions
    }
    qualifications {
      competencyName
    }
  }
}