Partners can export questionnaire submissions as part of the candidate application workflow.
This functionality is supported for questionnaires created:
- Manually through the direct job posting flow on the SEEK employer website, or the now-retired screen questionnaires page
Before you start with questionnaire submission queries, you will need to request a partner token.
A job ad may specify a questionnaire to include in SEEK’s Apply Form.
The candidate’s responses to the questionnaire are surfaced through the
seekQuestionnaireSubmission
field on the application profile.The
ApplicationQuestionnaireSubmission
object allows you to retrieve:- The
questionnaire
that the submission corresponds to - The list of
responses
to the components of the questionnaire - The
component
that a given response corresponds to
If you manage questionnaires as a holistic collection in your software,
retrieve
questionnaire.id
to correlate the submission back to the questionnaire ID you have stored from the Job Posting use case.If you manage individual questionnaire components in your software,
provide a unique
value
for each ApplicationQuestionnaireComponentInput
during questionnaire creation.
You can then select responses[].component.value
from the submission to correlate each response back to the corresponding questionnaire component in your software.Each
SingleSelect
and MultiSelect
ApplicationQuestion
specifies a collection of possible choices through the responseChoice
field.
An ApplicationQuestionChoice
can be preferenced by setting its preferredIndicator
during questionnaire creation.
Candidate responses are scored against these preferred choices.- The
ApplicationQuestionnaireSubmission
schema definition details scoring of the overall questionnaire submission - The
ApplicationQuestionResponse
schema definition details scoring of individual questionnaire components
These scores are provided as an advisory screening indicator for the hirer.
All candidate applications will be delivered to your software;
SEEK does not support knockout questions and does not reject applications based on score.
Use the
candidateProfile
query to retrieve questionnaire submissions.
You should combine this with the query you use to retrieve candidate profiles and attachments.query ($id: String!) {
candidateProfile(id: $id) {
seekQuestionnaireSubmission {
questionnaire {
id {
value
}
}
responses {
componentTypeCode
... on ApplicationQuestionResponse {
score
component {
value
questionHtml
}
answers {
answer
choice {
value
}
}
}
... on ApplicationPrivacyConsentResponse {
component {
value
descriptionHtml
}
consentGivenIndicator
}
}
score
}
}
}