---
title: "List demographic questions"
method: GET
path: "/v3/demographic_questions"
tags: ["Demographic Questions"]
---

# List demographic questions

`GET /v3/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.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `demographic_question_set_ids` integer[]
- `fields` string[]
- `active` boolean
- `required` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `sort_order` integer — Position of this question within its `demographic_question_set`, ascending. Lower values render first; aliased from the underlying `priority` column.
  - `active` boolean — `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.
  - `name` string, 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_id` integer, 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.
  - `required` boolean, 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.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)