---
title: "List Datasets Endpoint"
method: GET
path: "/api/v1/optimization/datasets"
tags: ["optimization"]
---

# List Datasets Endpoint

`GET /api/v1/optimization/datasets`

List registered datasets with optional module filter.

## Query parameters

- `module_slug` string, nullable — Filter by module slug
- `limit` integer — Maximum number of datasets to return.
- `offset` integer — Pagination offset into the dataset list.

## Response `200`

Successful Response

- DatasetListResponse — Paginated dataset listing.
  - `items` DatasetResponse[], required — Dataset list items.
    - `id` string, required — Unique dataset identifier.
    - `name` string, required — Human-readable dataset name.
    - `row_count` integer, required — Number of rows/examples in the dataset.
    - `format` string, required — File format (json or jsonl).
    - `module_slug` string, nullable — Associated module slug, when provided.
    - `created_at` string, required — ISO-8601 creation timestamp.
  - `total` integer, required — Total matching datasets.
  - `offset` integer, required — Current pagination offset.
  - `limit` integer, required — Current page size.
  - `has_more` boolean, required — Whether more results exist beyond this page.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `422` — Validation Error

## Changes

- **2026-05-23** `6178f925cdec` — 1 breaking, 3 info
  - the `detail` response's property type/format changed from `array`/`` to ``/`` for status `422`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `422`
  - added the required property `code` to the response with the `422` status
  - added the required property `message` to the response with the `422` status
- **2026-04-18** `1f45411d7556` — 1 breaking
  - the `items/items/id` response's property type/format changed from `integer`/`` to `string`/`` for status `200`
- **2026-04-14** `3044e5c4a9da` — 1 info
  - endpoint added
- **2026-03-19** `78507b29ed8f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/optimization/datasets/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/e25aaded81b9/schema)