---
title: "List Dataset Questions"
method: GET
path: "/datasets/{dataset_id}/questions"
tags: ["datasets"]
---

# List Dataset Questions

`GET /datasets/{dataset_id}/questions`

## Path parameters

- `dataset_id` string, uuid, required

## Response `200`

Successful Response

- Questions
  - `items` Question[], required
    - `id` string, uuid, required
    - `name` string, required
    - `title` string, required
    - `description` string, nullable
    - `required` boolean, required
    - `settings` union, required
      - TextQuestionSettings
        - `type` 'text', required
        - `use_markdown` boolean
        - `use_table` boolean
        - `columns` string[], nullable
      - RatingQuestionSettings
        - `type` 'rating', required
        - `options` RatingQuestionSettingsOption[], required
          - `value` integer, required
      - LabelSelectionQuestionSettings
        - `type` 'label_selection', required
        - `options` OptionSettings[], required
          - `value` string, required
          - `text` string, required
          - `description` string, nullable
        - `visible_options` integer, nullable
        - `strict` boolean
      - MultiLabelSelectionQuestionSettings
        - `type` 'multi_label_selection', required
        - `options` OptionSettings[], required
          - `value` string, required
          - `text` string, required
          - `description` string, nullable
        - `visible_options` integer, nullable
        - `strict` boolean
        - `options_order` 'natural' | 'suggestion'
      - RankingQuestionSettings
        - `type` 'ranking', required
        - `options` OptionSettings[], required
          - `value` string, required
          - `text` string, required
          - `description` string, nullable
      - SpanQuestionSettings
        - `type` 'span', required
        - `field` string, required
        - `options` OptionSettings[], required
          - `value` string, required
          - `text` string, required
          - `description` string, nullable
        - `visible_options` integer, nullable
        - `allow_overlapping` boolean — Allow spans overlapping
        - `allow_character_annotation` boolean — Allow character-level annotation
      - TableQuestionSettings
        - `type` 'table', required
        - `columns` string[], nullable
    - `dataset_id` string, uuid, required
    - `inserted_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

## Changes

- **2026-08-24** `ca32894f988c` — 7 info
  - removed the `label_selection` enum value from the `items/items/settings/oneOf[subschema #3: LabelSelectionQuestionSettings]/type` response property for the response status `200`
  - removed the `multi_label_selection` enum value from the `items/items/settings/oneOf[subschema #4: MultiLabelSelectionQuestionSettings]/type` response property for the response status `200`
  - removed the `ranking` enum value from the `items/items/settings/oneOf[subschema #5: RankingQuestionSettings]/type` response property for the response status `200`
  - removed the `rating` enum value from the `items/items/settings/oneOf[subschema #2: RatingQuestionSettings]/type` response property for the response status `200`
  - …3 more
- **2026-08-08** `e9da3a893a88` — 2 info
  - added the optional property `items/items/settings/oneOf[subschema #1: TextQuestionSettings]/columns` to the response with the `200` status
  - added the optional property `items/items/settings/oneOf[subschema #7: TableQuestionSettings]/columns` to the response with the `200` status

[Change history](https://skmtc.dev/hf/apis/extralit-v1/changes/datasets/:dataset_id/questions/get.md)

---

[API](https://skmtc.dev/hf/apis/extralit-v1.md) · [All operations](https://skmtc.dev/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/ca32894f988c/schema)