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

# Get Dataset Audit

`GET /datasets/{dataset_id}/audit`

Returns audit data by market date for a given dataset

* market_date: The market date for which the audit data is being returned

* number_of_datapoints: The total number of rows

* number_of_unique_time_index_values: The total number of unique time index
  values

* number_of_unique_subseries_index_values: The total number of unique
  subseries index values

* number_of_unique_publish_times_on_publish_date: The total number of
  unique publish time values where the publish time occurred on the given
  market date

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

- DatasetAuditResponse
  - `status_code` integer, required
  - `data` DatasetAudit[], required
    - `market_date` string, date, nullable, required
    - `number_of_datapoints` integer, nullable, required
    - `number_of_unique_time_index_values` integer, nullable, required
    - `number_of_unique_subseries_index_values` integer, nullable, required
    - `number_of_unique_publish_times_on_publish_date` integer, 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)