Skip to main content
GET
Get an export

Autorizações

Authorization
string
header
obrigatório

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 caminho

export_id
string<uuid>
obrigatório

The exportId returned when you created the export.

Resposta

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>
obrigatório

ID of your export.

Exemplo:

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

status
enum<string>
obrigatório

Current status of your export.

Opções disponíveis:
pending,
running,
completed,
failed
Exemplo:

"completed"

dataset
enum<string>
obrigatório

The dataset being exported.

Opções disponíveis:
monitoring_metrics
Exemplo:

"monitoring_metrics"

createdAt
string<date-time>
obrigatório

When you requested the export.

Exemplo:

"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.

Exemplo:

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

downloadExpiresAt
string<date-time> | null

When downloadUrl stops working.

Exemplo:

"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.

Exemplo:

"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.

Exemplo:

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