---
title: "list datasets"
method: GET
path: "/datasets"
tags: ["Dataset CRUD"]
---

# list datasets

`GET /datasets`

## Request

- Base URL: `https://api.riveterhq.com/v1`
- URL: `https://api.riveterhq.com/v1/datasets`
- Auth: HTTP bearer

The account's datasets, most recently updated first (up to 200). Each item is compact: id, name, column counts, `row_count`, and the newest run. Columns, the bound enrichment, and recent runs are on [GET /datasets/{id}](#tag/dataset-crud/get/datasets/{id}); rows on [GET /datasets/{id}/rows](#tag/dataset-crud/get/datasets/{id}/rows).

## Response `200`

Datasets listed

- object
  - `datasets` DatasetListItem[]
    - `id` string: ds_...
    - `name` string, nullable
    - `input_column_count` integer
    - `output_column_count` integer
    - `row_count` integer
    - `rows_expired` boolean
    - `newest_run` DatasetRunSummary: A run on a dataset, as the dataset lists it (the full run is GET /runs/{id})
      - `id` string: run_...
      - `type` 'dataset_build' | 'enrichment': dataset_build = list generation; enrichment = a fill
      - `status` string
      - `created_at` string, date-time
      - `finished_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing or invalid API key (`request_status` body — see the AuthError schema)
- `403`: The API key's account may not access this resource or endpoint (`forbidden`), or the account has not migrated to Datasets yet (`feature_not_enabled` — open Datasets in the app and click "Migrate to Datasets")

## Changes

- **2026-11-13** `fac56b649559`: 2 info
  - api tag `Dataset CRUD` added
  - api tag `Datasets` removed
- **2026-10-30** `dcb4d45ade1a`: 2 info
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `403` status
- **2026-10-19** `76aabcc5686b`: 2 info
  - api tag `Datasets` added
  - api tag `Datasets (beta)` removed
- **2026-10-13** `029668894d33`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/riveterhq/apis/riveter-api/changes/datasets/get.md)

---

[API](https://skmtc.dev/riveterhq/apis/riveter-api.md) - [All operations](https://skmtc.dev/riveterhq/apis/riveter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/riveterhq/apis/riveter-api/revisions/fac56b649559?raw)