---
title: "List available bulk export files for a dataset"
method: GET
path: "/csv-exports/{dataset_id}"
tags: ["CSV Exports"]
---

# List available bulk export files for a dataset

`GET /csv-exports/{dataset_id}`

List the per-day export files available on S3 for a dataset.

Each entry includes the partition date, object size, and last-modified
timestamp; combine with `GET /{dataset_id}/{date}` to fetch a presigned
URL for any specific file.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `year` integer, nullable — Optional. Restrict the listing to a single year.
- `month` integer, nullable — Optional. Restrict the listing to a single month. Requires `year`.
- `file_type` 'csv' — File format to list. Currently only `csv` (gzipped).
- `api_key` string, nullable — API key for authentication (query)

## Headers

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

## Response `200`

Successful Response

- DatasetExportsListResponse
  - `dataset_id` string, required
  - `file_type` 'csv', required
  - `count` integer, required
  - `files` DatasetExportFile[], required
    - `date` string, date, required — Partition date for this file.
    - `size_bytes` integer, required — Object size in bytes.
    - `last_modified` string, date-time, required — When the object was last written by the export pipeline.

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