---
title: "List scorecard questions"
method: GET
path: "/v3/scorecard_questions"
tags: ["Scorecard Questions"]
---

# List scorecard questions

`GET /v3/scorecard_questions`

Scorecard questions are the prompts configured on an `interview_kit` that interviewers answer when submitting a scorecard. Each question has a `question` body and an `answer_type` (`text`, `yes_no`, `single_select`, `multi_select`, or `instruction`); `single_select` and `multi_select` questions reference their choices through `/v3/scorecard_question_options`. Interviewer responses are returned separately as `scorecard_question_answers` on a candidate's scorecards. Filter to a single kit with `interview_kit_id` and to live questions 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
- `interview_kit_ids` integer[]
- `fields` string[]
- `active` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `interview_kit_id` integer — Id of the interview kit this question belongs to. Each `interview_kit` carries its own ordered set of scorecard questions, so the same prompt configured on two kits has two distinct `scorecard_question` rows.
  - `question` string — Text of the scorecard question — or, when `answer_type` is `instruction`, the body of the display-only instruction shown to interviewers. Supports basic HTML formatting (`<p>`, `<ul>`, `<li>`, `<b>`, `<i>`, `<a>`). Render or sanitize as needed.
  - `sort_order` integer — Position of this question within its interview kit, ascending. Lower values render first; aliased from the underlying `priority` column. Questions and `instruction` rows share a single ordering.
  - `active` boolean — `true` when the question is in use; `false` after it has been removed from the kit. Inactive questions are returned by default — pass `active=true` to filter to live questions only. Past `scorecard_question_answers` still reference inactive rows so historical scorecards stay readable.
  - `answer_type` 'text' | 'yes_no' | 'single_select' | 'multi_select' | 'instruction' — Shape of the answer the interviewer fills in. `text` is free-form rich text; `yes_no` is a binary choice; `single_select` and `multi_select` pick from the question's `scorecard_question_options`; `instruction` is a display-only guidance row with no answer field and no `required` semantics — instructions exist to script interviewers and do not produce a `scorecard_question_answer`. Immutable after the question is created.
  - `required` boolean — If `true`, an interviewer must answer this question before submitting the scorecard. Ignored when `answer_type` is `instruction`.

---

[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)