---
title: "List datasets"
method: GET
path: "/v1/datasets"
---

# List datasets

`GET /v1/datasets`

Retrieve a paginated list of datasets with optional filtering by owner and type

## Query parameters

- `api_key` string
- `limit` integer
- `offset` integer
- `owner_handle` string
- `type` string

## Headers

- `X-Dune-Api-Key` string, required

## Response `200`

OK

- ModelsListDatasetsResponse
  - `datasets` ModelsDatasetResponse[]
    - `columns` ModelsDatasetColumn[]
      - `metadata` ModelsDatasetColumnMetadata
        - `description` string
        - `filtering_column` boolean
      - `name` string
      - `nullable` boolean
      - `type` string
    - `created_at` string
    - `full_name` string
    - `is_private` boolean
    - `metadata` unknown
    - `owner` ModelsDatasetOwner
      - `handle` string
      - `type` string
    - `type` string
    - `updated_at` string
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/dune/apis/duneapi.md) · [All operations](https://skmtc.dev/dune/apis/duneapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dune/duneapi/revisions/f3a7a865f95b/schema)