Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Demographic Question Sets

List demographic question sets

Demographic question sets are named groupings of demographic_questions an organization attaches to a job post or candidate survey to collect self-reported applicant demographic data (e.g. for DE&I reporting). A set is either custom (defined by the organization) or linked to a Greenhouse-supplied standard set; in both cases its child questions live under /v3/demographic_questions?demographic_question_set_id={id}. Inactive (soft-removed) and disabled sets are returned by default so historical applicant submissions stay readable — use active and enabled to narrow to live sets only.

get/v3/demographic_question_sets

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

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
fieldsstring[]

Comma separated list of fields to return

activeboolean

Filter by lifecycle state. true returns only live sets; false returns only soft-removed sets. Omit to return both.

enabledboolean

Filter by whether the set is available for selection on new job posts and candidate surveys. true returns sets that are explicitly enabled or have a null enabled value (legacy rows predate the column and are treated as enabled); false returns sets the organization has explicitly disabled.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
titlestring

Name of the demographic question set, unique within the organization among active sets. Used as the section header for the grouping when the set is attached to a job post or candidate survey.

descriptionstring nullable

External-facing copy shown to applicants above the questions on a job post or candidate survey, explaining why the organization is collecting this data. Required once any question in the set is marked required; otherwise optional.

activeboolean

true for sets currently in use; false after the set has been soft-removed (which also marks its demographic_questions inactive). Inactive sets are returned by default — pass active=true to filter to live sets only. Past applications continue to reference inactive sets so historical demographic responses stay readable.

enabledboolean nullable

Whether the set is available for selection on new job posts and candidate surveys. true and null both mean enabled (legacy rows predate the column and are treated as enabled); pass enabled=false to filter to sets the organization has explicitly disabled.