---
title: "List datasets"
method: GET
path: "/datasets"
tags: ["datasets"]
---

# List datasets

`GET /datasets`

Lists datasets for the authenticated user, most recently updated first. Supports an optional case-insensitive name search.

## Query parameters

- `search` string

## Headers

- `Api-Key` string, required

## Response `200`

Datasets retrieved successfully

- ListDatasetsResponse
  - `datasets` Dataset[], required — Matching datasets, most recently updated first.
    - `dataset_id` string, required — Unique identifier for the dataset.
    - `name` string, required — Display name of the dataset.
    - `user_id` string, required — ID of the user who owns this dataset.
    - `creation_time` string, date-time, required — When the dataset was created.

## Other responses

- `401` — Unauthorized

## Changes

- **2026-08-28** `d4cec35f719f` — 1 warning, 1 info
  - removed the optional property `datasets/items/cover_asset_identifier` from the response with the `200` status
  - api operation id `list-datasets` removed and replaced with `list_datasets`
- **2026-08-21** `5b667dae2a60` — 1 warning
  - for the `query` request parameter `search`, the maxLength was set to `64`

[Change history](https://skmtc.dev/ideogram/apis/api-reference/changes/datasets/get.md)

---

[API](https://skmtc.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)