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

## 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.
    - `cover_asset_identifier` AssetIdentifier — An identifier for an ideogram asset.
      - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required
      - `asset_id` string, required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)