Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Demographic Questions

List demographic questions

Demographic questions are the voluntary self-identification prompts applicants see on job posts and candidate surveys (separate from the EEOC questionnaire, which carries its own legally-mandated wording). Each question belongs to a demographic_question_set, has a single- or multi-select answer_type, and pulls its choices from demographic_answer_options. The set returned here includes both organization-defined custom questions and Greenhouse-provided U.S. Standard Demographic Questions; standard ones are not editable.

get/v3/demographic_questions

Query parameters

cursorstring

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

demographic_question_set_idsinteger[]

Comma separated list

fieldsstring[]

Comma separated list of fields to return

activeboolean

Filter by whether the question is still in use on its set. Defaults to returning both active and removed questions; set true for live questions only, false for removed only.

requiredboolean

Filter by whether applicants are obligated to answer the question before submitting. Set true for required questions, false for optional ones; defaults to returning both. Standard Greenhouse-supplied questions where required is null are not matched by either value.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
sort_orderinteger

Position of this question within its demographic_question_set, ascending. Lower values render first; aliased from the underlying priority column.

activeboolean

true when the question is in use on its set; false after it has been soft-removed. Inactive questions are returned by default — pass active=true to filter to live questions only. Past demographic_answers continue to reference inactive rows so historical applicant submissions stay readable.

namestring nullable

Prompt text shown to applicants (e.g. How would you describe your gender identity?). null on standard Greenhouse-supplied questions where the displayed prompt is rendered by the candidate-facing application from a localized template rather than this column.

demographic_question_set_idinteger nullable

Id of the demographic_question_set this question belongs to. A set is what gets attached to a job post or candidate survey; questions are scoped to one set and never shared across sets. null for legacy questions not yet associated with a set.

requiredboolean nullable

If true, applicants must select an answer (or the auto-added I don't wish to answer option) before submitting the application. Standard Greenhouse-supplied questions return null since their requiredness is controlled at the question-set level.

answer_type'multi_value_single_select' | 'multi_value_multi_select' nullable

Shape of the answer the applicant can submit. multi_value_single_select is a single-choice question; multi_value_multi_select lets the applicant pick more than one option. Both types draw their choices from /v3/demographic_answer_options?demographic_question_id={id}. Free-text demographic questions are not supported.