Exporting questionnaire submissions

Exporting questionnaire submissions

Partners can export questionnaire submissions as part of the candidate application workflow. This functionality is supported for questionnaires created either:

Before you begin

Before you start with questionnaire submission queries, you will need to request a partner token.

Data structure

CandidateProfileQuestionnaireSubmissionQuestionnaireComponentResponseComponentcontainscorresponds tocontainscorresponds to
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

Questionnaire association

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.

Preferred choices & scoring

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.
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.

Operations

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

candidateProfile

QueryVariablesResult
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