---
title: "List scorecard question options"
method: GET
path: "/v3/scorecard_question_options"
tags: ["Scorecard Question Options"]
---

# List scorecard question options

`GET /v3/scorecard_question_options`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/scorecard_question_options`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:scorecard_question_options:list`
  - HTTP bearer

Scorecard question options are the multiple-choice values shown to interviewers for `single_select` and `multi_select` `scorecard_questions`. Each option belongs to a single parent question; the interviewer's selection is recorded on a `scorecard_question_answer` through the `scorecard_question_answer_options` join. Filter to a single question with `scorecard_question_id` and to live options with `active=true`.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `scorecard_question_ids` integer[]
- `fields` string[]
- `active` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `scorecard_question_id` integer: Id of the parent `scorecard_question` this option belongs to. Only questions with `answer_type` of `single_select` or `multi_select` carry options.
  - `name` string: Display label shown to interviewers in the scorecard dropdown (e.g. `Strong Hire`, `No Hire`). Persisted verbatim as the choice text on `scorecard_question_answers` that select this option via the `scorecard_question_answer_options` join.
  - `sort_order` integer: Display position within the parent question's choice list. Lower values render first; ties fall back to insertion order. Alias of the underlying `priority` column.
  - `active` boolean: `true` while the option is selectable on new scorecards. Set to `false` after removal — historical `scorecard_question_answers` that already selected the option are preserved, so past scorecards still resolve to the original label.

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)