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

# List Dataset Fields

`GET /datasets/{dataset_id}/fields`

## Path parameters

- `dataset_id` string, uuid, required

## Response `200`

Successful Response

- Fields
  - `items` Field[], required
    - `id` string, uuid, required
    - `name` string, required
    - `title` string, required
    - `required` boolean, required
    - `settings` union, required
      - TextFieldSettings
        - `type` 'text', required
        - `use_markdown` boolean, required
        - `use_table` boolean, required
      - ImageFieldSettings
        - `type` 'image', required
      - ChatFieldSettings
        - `type` 'chat', required
        - `use_markdown` boolean, required
      - CustomFieldSettings
        - `type` 'custom', required
        - `template` string, required
        - `advanced_mode` boolean, required
      - TableFieldSettings
        - `type` 'table', required
      - ColumnFieldSettings
        - `type` 'column', required
        - `dtype` string, required
        - `nullable` boolean
        - `review` object, 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` — 6 info
  - removed the `chat` enum value from the `items/items/settings/oneOf[subschema #3: ChatFieldSettings]/type` response property for the response status `200`
  - removed the `column` enum value from the `items/items/settings/oneOf[subschema #6: ColumnFieldSettings]/type` response property for the response status `200`
  - removed the `custom` enum value from the `items/items/settings/oneOf[subschema #4: CustomFieldSettings]/type` response property for the response status `200`
  - removed the `image` enum value from the `items/items/settings/oneOf[subschema #2: ImageFieldSettings]/type` response property for the response status `200`
  - …2 more
- **2026-08-08** `e9da3a893a88` — 1 breaking, 1 info
  - added `#/components/schemas/ColumnFieldSettings` to the `items/items/settings` response property `oneOf` list for the response status `200`
  - added `column` discriminator mapping keys to the `items/items/settings` response property for the response status `200`

[Change history](https://skmtc.dev/hf/apis/extralit-v1/changes/datasets/:dataset_id/fields/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)