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

# List datasets

> List available datasets, optionally filtered by source.



## OpenAPI

````yaml GET /v1/datasets
openapi: 3.1.0
info:
  title: GridCertainty Public API
  description: >-
    Read-only public API for ERCOT datasets, pricing locations, reports, and
    system metadata.
  version: 1.0.0
servers:
  - url: https://api.felixfusion.ai
    description: Production public API
  - url: http://localhost:8001
    description: Local public API
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
paths:
  /v1/datasets:
    get:
      tags:
        - Dataset Metadata
      summary: List datasets
      description: List available datasets, optionally filtered by source.
      operationId: list_datasets
      parameters:
        - $ref: '#/components/parameters/source'
        - $ref: '#/components/parameters/return_format'
        - $ref: '#/components/parameters/download'
        - $ref: '#/components/parameters/json_schema'
      responses:
        '200':
          description: Dataset catalog
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDatasetsResponse'
            text/csv:
              schema:
                type: string
components:
  parameters:
    source:
      name: source
      in: query
      schema:
        type: string
      description: Filter datasets by source, for example `ercot`.
    return_format:
      name: return_format
      in: query
      schema:
        type: string
        enum:
          - json
          - csv
        default: json
      description: Return response as JSON or CSV.
    download:
      name: download
      in: query
      schema:
        type: boolean
        default: false
      description: Set true to request a downloadable attachment response.
    json_schema:
      name: json_schema
      in: query
      schema:
        type: string
        default: array_of_objects
      description: Optional JSON schema output mode.
  schemas:
    ListDatasetsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Dataset'
        meta:
          $ref: '#/components/schemas/Metadata'
    Dataset:
      type: object
      properties:
        id:
          type: string
        source:
          type:
            - string
            - 'null'
        name:
          type: string
        description:
          type: string
        cadence:
          type:
            - string
            - 'null'
        earliestData:
          type:
            - string
            - 'null'
      additionalProperties: true
    Metadata:
      type: object
      properties:
        page:
          type:
            - integer
            - 'null'
        limit:
          type:
            - integer
            - 'null'
        page_size:
          type:
            - integer
            - 'null'
        hasNextPage:
          type:
            - boolean
            - 'null'
        cursor:
          type:
            - string
            - 'null'
      additionalProperties: true
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key

````