---
title: "Generate a presigned S3 URL for a bulk export file"
method: GET
path: "/csv-exports/{dataset_id}/{export_date}"
tags: ["CSV Exports"]
---

# Generate a presigned S3 URL for a bulk export file

`GET /csv-exports/{dataset_id}/{export_date}`

Return a time-limited presigned URL for a bulk export object on S3.

Caller supplies dataset id, date, and (optionally) file type; the server
constructs the S3 key per the layout documented in
`gitbook/bulk-csv-download/folder-structure.md`.

## Path parameters

- `dataset_id` string, required
- `export_date` string, date, required — ISO 8601 date of the partition, e.g. `2025-03-14`.

## Query parameters

- `file_type` 'csv' — File format. Currently only `csv` (gzipped) is available.
- `api_key` string, nullable — API key for authentication (query)

## Headers

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

## Response `200`

Successful Response

- PresignedUrlResponse
  - `presigned_url` string, required — Time-limited HTTPS URL to download the requested file.
  - `expires_in_seconds` integer, required — Number of seconds the presigned URL is valid for.
  - `bucket` string, required — S3 bucket the object lives in.
  - `object_key` string, required — S3 object key the URL points to.

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