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.
Please check with your SEEK contact before starting any build work described here.
Use the GraphQL
candidateProfile
query with the candidateId
from the authorization flow.
This will retrieve candidate profile data that can pre-fill your software’s application form.query ($id: String!) {
candidateProfile(id: $id) {
profileId {
value
}
createDateTime
candidate {
person {
name {
given
family
}
communication {
phone {
formattedNumber
}
email {
address
}
}
}
}
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
}
attachments {
descriptions
seekRoleCode
url
}
}
}
Please note that the
candidateprofile
query can only be called with the candidateId
once per authorization, subsequent calls will return a FORBIDDEN response.
If your system needs to retrieve the candidate details again, for example where a candidate is applying for an additional job, your system will need to have the candidate repeat the authorization process.