This content is still in draft.
Partners can export questionnaire submissions as part of the candidate application workflow.
This functionality is supported for questionnaires created either:
- Manually on the SEEK Employer website
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 native apply form.
If a candidate completed a questionnaire as part of their job application,
their responses 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,
supply a unique reference
value
for each ApplicationQuestionnaireComponent
during questionnaire creation.
You can then retrieve responses.*.component.value
from the submission to correlate each response back to its corresponding component.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.QueryVariablesResult
Copy Playground
query($id: String!) {
candidateProfile(id: $id) {
seekQuestionnaireSubmission {
score
questionnaire {
id {
value
}
}
responses {
componentTypeCode
... on ApplicationQuestionResponse {
score
component {
value
questionHtml
}
answers {
answer
choice {
value
}
}
}
... on ApplicationPrivacyConsentResponse {
component {
value
descriptionHtml
}
consentGivenIndicator
}
}
}
}
}
Application Export
Use cases
Use cases