Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Bulk exports

Export status

GET

/v2/exports/{id}

Business and up

View as MarkdownTry in Playground →

Returns a single export. Check it every few seconds until status becomes ready (or failed); building a season takes anywhere from a few seconds (when cached) to a few minutes. files contains a download URL for each file, valid for one hour (see linksExpireAt); request the export again to get new links.

Parameters

id

pathrequired

export id issued by DataSportsAPI, a positive integer

Response

data
Export

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/exports/{id}"
Example
{ "data": { "id": 42, "league": 17, "season": 61627, "format": "parquet", "status": "ready", "error": null,
            "fixtureCount": 380, "createdAt": "2026-11-01T18:00:00.000Z", "finishedAt": "2026-11-01T18:00:41.000Z",
            "files": [ { "name": "fixtures.parquet", "bytes": 21944, "contentType": "application/vnd.apache.parquet", "url": "https://…" },
                       { "name": "standings.parquet", "bytes": 3120, "contentType": "application/vnd.apache.parquet", "url": "https://…" } ],
            "linksExpireAt": "2026-11-01T19:01:02.000Z" } }