> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Datasets

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

<Info>
  Minimum required API key scope: `Read`
</Info>

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


## OpenAPI

````yaml GET /v1/datasets
openapi: 3.0.1
info:
  contact: {}
  description: Dune API
  title: DuneAPI
  version: '1.0'
servers:
  - url: https://api.dune.com/api
security: []
paths:
  /v1/datasets:
    get:
      summary: List datasets
      description: >-
        Retrieve a paginated list of datasets with optional filtering by owner
        and type
      parameters:
        - description: API Key for the service
          in: header
          name: X-Dune-Api-Key
          required: true
          schema:
            type: string
        - description: API Key, alternative to using the HTTP header X-Dune-Api-Key
          in: query
          name: api_key
          schema:
            type: string
        - description: Number of results to return (default 50, max 250)
          in: query
          name: limit
          schema:
            type: integer
        - description: Offset for pagination
          in: query
          name: offset
          schema:
            type: integer
        - description: Filter by owner handle
          in: query
          name: owner_handle
          schema:
            type: string
        - description: >-
            Filter by dataset types (comma-separated: transformation_view,
            transformation_table, uploaded_table, decoded_table, spell,
            dune_table)
          in: query
          name: type
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ListDatasetsResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error400'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error401'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error403'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error404'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error500'
          description: Internal Server Error
components:
  schemas:
    models.ListDatasetsResponse:
      properties:
        datasets:
          items:
            $ref: '#/components/schemas/models.DatasetResponse'
          type: array
        total:
          type: integer
      type: object
    models.Error400:
      properties:
        error:
          example: Bad Request
          type: string
      type: object
    models.Error401:
      properties:
        error:
          example: Invalid API Key
          type: string
      type: object
    models.Error403:
      properties:
        error:
          example: >-
            Not allowed to execute query. Query is archived, unsaved or not
            enough permissions
          type: string
      type: object
    models.Error404:
      properties:
        error:
          example: Object not found
          type: string
      type: object
    models.Error500:
      properties:
        error:
          example: Internal error
          type: string
      type: object
    models.DatasetResponse:
      properties:
        columns:
          items:
            $ref: '#/components/schemas/models.DatasetColumn'
          type: array
        created_at:
          type: string
        full_name:
          type: string
        is_private:
          type: boolean
        metadata: {}
        owner:
          $ref: '#/components/schemas/models.DatasetOwner'
        type:
          type: string
        updated_at:
          type: string
      type: object
    models.DatasetColumn:
      properties:
        metadata:
          $ref: '#/components/schemas/models.DatasetColumnMetadata'
        name:
          type: string
        nullable:
          type: boolean
        type:
          type: string
      type: object
    models.DatasetOwner:
      properties:
        handle:
          type: string
        type:
          type: string
      type: object
    models.DatasetColumnMetadata:
      properties:
        description:
          type: string
        filtering_column:
          type: boolean
      type: object

````