---
title: "Dataset Updates"
method: GET
path: "/dataset-updates/{dataset_id}"
tags: ["Dataset Updates"]
---

# Dataset Updates

`GET /dataset-updates/{dataset_id}`

List all updates that have occurred in chronological order
for a specific dataset

## 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'
- `order` 'asc' | 'desc'
- `limit` integer, nullable — The maximum number of rows to return across all pages

## Headers

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

## Response `200`

Successful response

- DatasetUpdatesResponse
  - `status_code` integer, required
  - `data` DatasetUpdateResponse[], required
    - `id` string, required
    - `dataset` string, required
    - `time_utc` string, date-time, required
    - `num_rows_updated` integer, required
    - `num_rows_inserted` integer, required
    - `is_backfill` boolean, nullable, required
  - `meta` MetadataResponse, required
    - `page` integer, required
    - `limit` integer, nullable, required
    - `page_size` integer, nullable, required
    - `hasNextPage` boolean, nullable, required
    - `cursor` string, nullable, required

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