Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Bulk exports

Create an export

POST

/v2/exports

Business and up

View as Markdown

Kicks off an export of a single league season. JSON body: league (DataSportsAPI league id), season (taken from /v2/leagues/{id}/seasons) and format, one of json (the default — a single season.json containing league, season, rounds, all fixtures, standings, top players and top teams exactly as the endpoints return them), csv or parquet (each giving two flat tables: fixtures and standings). The response is 202 with the export object, in status pending.

Fixtures are collected round by round, so a competition our data source does not split into rounds (NBA and NHL regular seasons) produces an export without fixtures; the export’s error field lists whatever could not be read (“not included: topPlayers”). Because we mirror the source’s listing, a match that was postponed and replayed later may appear twice — once as the postponed fixture and once as the played one, each with its own id (Premier League 25/26: 381 fixtures, one of them postponed). Columns in the CSV / Parquet files — fixtures: fixture_id, sport, start_time, round, round_name, status, status_description, home_team_id, home_team, away_team_id, away_team, home_score, away_score, winner, venue; standings: table, primary, position, team_id, team, played, wins, draws, losses, scores_for, scores_against, points, zone.

Response

data
Export
errors
404 not_found — the league does not exist, or the season does not belong to it429 export_limit — the allowance of 20 exports per UTC day has been used up

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

Example
$ curl -X POST -H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" \
    -d '{ "league": 17, "season": 61627, "format": "parquet" }' https://api.datasportsapi.com/v2/exports

{ "data": { "id": 42, "league": 17, "season": 61627, "format": "parquet", "status": "pending", "error": null,
            "fixtureCount": null, "createdAt": "2026-11-01T18:00:00.000Z", "finishedAt": null, "files": [] } }