List Datasets

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

GET /v1/datasets

List datasets

cURL

curl --request GET \
  --url https://api.dune.com/api/v1/datasets \
  --header 'X-Dune-Api-Key: <x-dune-api-key>'

200

{
  "datasets": [
    {
      "columns": [
        {
          "metadata": {
            "description": "<string>",
            "filtering_column": true
          },
          "name": "<string>",
          "nullable": true,
          "type": "<string>"
        }
      ],
      "created_at": "<string>",
      "full_name": "<string>",
      "is_private": true,
      "metadata": "<unknown>",
      "owner": {
        "handle": "<string>",
        "type": "<string>"
      },
      "type": "<string>",
      "updated_at": "<string>"
    }
  ],
  "total": 123
}

Minimum required API key scope: Read

Use Cases

• Browse Available Data: Programmatically discover all tables and datasets available on Dune for querying.
• Filter by Owner: Find all datasets owned by a specific user or team using owner_handle parameter.
• Filter by Type: Narrow down results to specific dataset types like curated tables, decoded tables, or transformations using the type parameter.
• Build Data Catalogs: Create custom data discovery tools that index and search through Dune’s table ecosystem.
• Access Management: Audit and manage datasets owned by your team or organization.

Headers

X-Dune-Api-Key · string · required

API Key for the service

Query Parameters

api_key · string

API Key, alternative to using the HTTP header X-Dune-Api-Key

limit · integer

Number of results to return (default 50, max 250)

offset · integer

Offset for pagination

owner_handle · string

Filter by owner handle

type · string

Filter by dataset types (comma-separated: transformation_view, transformation_table, uploaded_table, decoded_table, spell, dune_table)

Response

200

application/json

OK

datasets · object[]

Show child attributes

total · integer