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

A job ad may specify a questionnaire to include in SEEK’s native 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

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

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