IndeedApplyScreenerQuestionsDefinitionInput
Input Object
Input for Indeed Apply screener questions.
Fields
screenerQuestions [ScreenerQuestionBodyInput!]! Required
Job-related questions about experience, skills, and certifications.
Do not include demographic questions about ethnicity, gender, or disability.
Some jurisdictions regulate protected-class questions. Handle those questions separately.
textarea TextAreaQuestionInput
Long-form answer. Shows a multi-line text field.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
minCharCount Int
Minimum character count for answer.
maxCharCount Int
Maximum character count for answer.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
validationRuleKey String
Optional key for an external validation rule. Indeed enforces it on the job seeker's answer at apply time. Unknown keys fail ingestion.
text TextScreenerQuestionInput
Short answer. Shows a single-line text field.
Formats: integer, decimal, numeric_text.
See JSON questions parameters.
integer IntegerTextScreenerQuestionInput
Integer answers only. No decimals or leading zeros.
decimal DecimalTextScreenerQuestionInput
Numeric answers. Allows leading zeros and decimals.
numeric NumericTextQuestionInput
Numeric answers only. No decimals.
freeform FreeformTextQuestionInput
Text answers.
select SelectScreenerQuestionInput
Multiple-choice question. Job seekers select one answer.
1–5 options: radio buttons. 6 or more: dropdown.
questionInput SelectQuestionInput
Select question format and metadata.
qualification SelectQualificationQuestionInput
Qualification for this question. Indeed still delivers applications that do not meet the criterion (NON_BLOCKING).
multiselect MultiselectScreenerQuestionInput
Multiple-answer question. Shows checkboxes.
questionInput MultiselectQuestionInput
Multi-select question format and metadata.
qualification MultiSelectQualificationQuestionInput
Qualification for this question. Indeed still delivers applications that do not meet the criterion (NON_BLOCKING).
hierarchical HierarchicalQuestionInput
Follow-up questions based on a previous answer.
Example: Select a state, then show cities in that state.
Limited to 3 levels (for example, state → city → county).
Similar to conditional questions. Prefer this when the first selection defines the next options. This reduces the number of questions.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
options [SelectOptionInput!]! Required
Options.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
hierarchicalOptions [HierarchicalOptionInput!]! Required
Follow-up questions based on a previous answer.
Example: Select a state, then show cities in that state.
Limited to 3 levels.
date DateScreenerQuestionInput
Date question. Shows a date field.
Use dd/MM/yyyy or a Unicode CLDR locale format. Indeed uses SimpleDateFormat.
Use MM for month (mm causes errors). Use yyyy for year (yy can confuse job seekers).
The format affects ATS data transfer and min/max parsing. Job seekers enter dates in their locale format.
questionInput DateQuestionInput
Date question format and metadata.
qualification DateQuestionQualificationInput
Qualification for this question. Indeed still delivers applications that do not meet the criterion (NON_BLOCKING).
file FileQuestionInput
File upload for certifications, portfolios, or work samples.
JSON POST response fields: contentType, data, fileName.
Valid file types: doc, docx, gif, jfif, jif, jpe, jpeg, jpg, pdf, png, rtf, tif, tiff, txt
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
format [String!]
Supported file formats. Omit to allow all formats.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
min Int
Minimum file uploads.
max Int
Maximum file uploads.
information InformationQuestionInput
Display-only text for explanations or section headings. Job seekers do not answer.
See information.
id ID! Required
Unique question ID.
text String! Required
Displayed text.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
pageBreak PageBreakQuestionInput
Groups questions on a page. Questions between page breaks appear together.
Maximum: 20 questions per page. Default: 3 per page on desktop, all on one page on mobile.
id ID! Required
Unique question ID.
multifield MultifieldQuestionInput
Multi-field question.
Groups a fixed set of sub-questions that the job seeker can submit more than once. For example, enter work experience for each previous job.
This reduces the need for conditional “Do you have more to add?” question chains. Use it only in screener questions.
Do not nest it. A MULTIFIELD cannot appear inside another MULTIFIELD groupedQuestionFields.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
minEntryCount Int
Minimum number of entries the job seeker must submit. 0 means optional. Default: 1.
maxEntryCount Int
Maximum number of entries the job seeker can submit. Must be greater than or equal to minEntryCount. Default: 15.
groupLabel String! Required
Label above each entry group. For example, Work Experience.
addButtonLabel String! Required
Label on the add button. For example, Add Another Job.
groupedQuestionFields [ScreenerQuestionBodyInput!]! Required
Sub-questions repeated for each entry. Any ScreenerQuestionBodyInput variant except another multifield. Validation rejects nested multifield.
demographicQuestions [DemographicQuestionsBodyInput!]! Required
Questions about a protected class, such as ethnicity, gender, or disability.
Some jurisdictions regulate these questions. Indeed and your systems must handle them separately.
Limited to U.S. jobs for EEO compliance.
Do not include job-related questions about work experience, skills, or certifications.
Put those in screenerQuestions.
textarea TextAreaQuestionInput
Long-form answer. Shows a multi-line text field.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
minCharCount Int
Minimum character count for answer.
maxCharCount Int
Maximum character count for answer.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
validationRuleKey String
Optional key for an external validation rule. Indeed enforces it on the job seeker's answer at apply time. Unknown keys fail ingestion.
text TextQuestionInput
Short answer. Shows a single-line text field.
Formats: integer, decimal, numeric_text.
See JSON questions parameters.
integer IntegerTextQuestionInput
Integer answer.
decimal DecimalTextQuestionInput
Decimal or floating-point answer.
numeric NumericTextQuestionInput
Numeric text answer (for example, identifiers with leading zeros).
freeform FreeformTextQuestionInput
Freeform text answer.
select SelectQuestionInput
Multiple-choice question. Job seekers select one answer.
1–5 options: radio buttons. 6 or more: dropdown.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
options [SelectOptionInput!]! Required
Options.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
multiselect MultiselectQuestionInput
Multiple-answer question. Shows checkboxes.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
options [SelectOptionInput!]! Required
Options.
minSelectionCount Int
Minimum selectable options.
maxSelectionCount Int
Maximum selectable options.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
date DateQuestionInput
Date question. Shows a date field.
Use dd/MM/yyyy or a Unicode CLDR locale format. Indeed uses SimpleDateFormat.
Use MM for month (mm causes errors). Use yyyy for year (yy can confuse job seekers).
The format affects ATS data transfer and min/max parsing. Job seekers enter dates in their locale format.
id ID! Required
Unique question ID.
question String! Required
Displayed question text.
format String! Required
Use dd/MM/yyyy or a Unicode CLDR locale format. Indeed uses SimpleDateFormat.
Use MM for month (mm causes errors). Use yyyy for year (yy can confuse job seekers).
The format affects ATS data transfer and min/max parsing. Job seekers enter dates in their locale format.
minDate DateTime
Earliest allowed date.
maxDate DateTime
Latest allowed date.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
required Boolean! default:false
If true, the question is required. Unanswered optional questions return "". Default: false.
information InformationQuestionInput
Display-only text for explanations or section headings. Job seekers do not answer.
See information.
id ID! Required
Unique question ID.
text String! Required
Displayed text.
condition ConditionConstraintInput
Show this question only when a previous answer matches. Set the previous question ID and the value that activates this question.
Example: If the applicant answers yes to military service, show a follow-up about branch of service.
pageBreak PageBreakQuestionInput
Groups questions on a page. Questions between page breaks appear together.
Maximum: 20 questions per page.
Default: 3 per page on desktop, all on one page on mobile.
id ID! Required
Unique question ID.
Example
{ "screenerQuestions": [ScreenerQuestionBodyInput], "demographicQuestions": [DemographicQuestionsBodyInput]}