Skip to main content
GET
Get an export

Autorizaciones

Authorization
string
header
requerido

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Parámetros de ruta

export_id
string<uuid>
requerido

The exportId returned when you created the export.

Respuesta

Your export. A completed one includes a download link, or message when it has no rows.

Your export. A completed one includes a download link, or message when it has no rows.

exportId
string<uuid>
requerido

ID of your export.

Ejemplo:

"218ad339-00cd-4e11-aeaa-8d96694908a0"

status
enum<string>
requerido

Current status of your export.

Opciones disponibles:
pending,
running,
completed,
failed
Ejemplo:

"completed"

dataset
enum<string>
requerido

The dataset being exported.

Opciones disponibles:
monitoring_metrics
Ejemplo:

"monitoring_metrics"

createdAt
string<date-time>
requerido

When you requested the export.

Ejemplo:

"2026-09-08T14:03:12Z"

downloadUrl
string | null

Link to download the Parquet file, present only when status is completed and the export has data. It is valid for 1 hour; check the export again to get a new link.

Ejemplo:

"https://downloads.example.com/exports/218ad339-00cd-4e11-aeaa-8d96694908a0.parquet?expires=3600&signature=..."

downloadExpiresAt
string<date-time> | null

When downloadUrl stops working.

Ejemplo:

"2026-09-08T15:21:40Z"

error
string | null

Why the export failed, present only when status is failed. One of An unexpected error occurred., The export result did not match the expected schema or Export exceeded the processing time limit. Request a new export to try again.

Ejemplo:

"Export exceeded the processing time limit"

message
string | null

Present only when status is completed but no rows matched your request, so there is no file to download: No data was found for the requested date range.

Ejemplo:

"No data was found for the requested date range."