---
title: "List Datasets"
method: GET
path: "/datasets"
tags: ["Dataset Metadata"]
---

# List Datasets

`GET /datasets`

List all published datasets a user has access to

See list of available datasets here: https://www.gridstatus.io/datasets

## Query parameters

- `api_key` string, nullable — API key for authentication (query)
- `return_format` 'json' | 'csv'
- `download` boolean — Whether to download the file or not
- `json_schema` 'array-of-objects' | 'array-of-arrays'

## Headers

- `x-api-key` string, nullable — API key for authentication (header)

## Response `200`

Successful response

- ListDatasetsResponse
  - `status_code` integer, required
  - `data` DatasetResponse[], required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `earliest_available_time_utc` string, date-time, nullable, required
    - `latest_available_time_utc` string, date-time, nullable, required
    - `source` string, nullable, required
    - `last_checked_time_utc` string, date-time, nullable, required
    - `primary_key_columns` string[], nullable, required
    - `publish_time_column` string, nullable, required
    - `time_index_column` string, nullable, required
    - `subseries_index_column` string, nullable, required
    - `all_columns` ColumnResponse[], nullable, required
      - `name` string, required
      - `type` string, required
      - `is_numeric` boolean, required
      - `is_date` boolean
      - `is_datetime` boolean, required
    - `number_of_rows_approximate` integer, nullable, required
    - `table_type` string, nullable, required
    - `is_in_snowflake` boolean, nullable, required
    - `data_frequency` string, nullable, required
    - `source_url` string, nullable, required
    - `publication_frequency` string, nullable, required
    - `is_published` boolean, nullable, required
    - `created_at_utc` string, date-time, nullable, required
    - `status` 'retired' | 'active' | 'deprecated', required
    - `popularity_rank` integer, nullable
  - `meta` MetadataResponse, required
    - `page` integer, required
    - `limit` integer, nullable, required
    - `page_size` integer, nullable, required
    - `hasNextPage` boolean, nullable, required
    - `cursor` string, nullable, required
  - `dataset_metadata` ListDatasetsDatasetMetadataResponse, required
    - `resample_conversion` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/gridstatus/apis/grid-status-api.md) · [All operations](https://skmtc.net/gridstatus/apis/grid-status-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gridstatus/grid-status-api/versions/fa1f094be2d4/schema)