v2

latestOpenAPI 3.1.02026-07-312954143.9 KB
CSV Exports

Generate a presigned S3 URL for a bulk export file

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.

get/csv-exports/{dataset_id}/{export_date}

Path parameters

dataset_idstring required
export_datestring date required

ISO 8601 date of the partition, e.g. 2025-03-14.

ISO 8601 date of the partition, e.g. 2025-03-14.

Query parameters

file_type'csv'

File format. Currently only csv (gzipped) is available.

File format. Currently only csv (gzipped) is available.

api_keystring nullable

API key for authentication (query)

API key for authentication (query)

Headers

x-api-keystring nullable

API key for authentication (header)

API key for authentication (header)

Response

Successful Response

presigned_urlstring required

Time-limited HTTPS URL to download the requested file.

expires_in_secondsinteger required

Number of seconds the presigned URL is valid for.

bucketstring required

S3 bucket the object lives in.

object_keystring required

S3 object key the URL points to.