---
title: "Get Dataset Metadata"
method: GET
path: "/datasets/{dataset_id}"
tags: ["Dataset Metadata"]
---

# Get Dataset Metadata

`GET /datasets/{dataset_id}`

Get a dataset and its metadata

## Path parameters

- `dataset_id` string, required

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

- DatasetResponse
  - `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

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