Skip to content
datasportsAPI

Bulk exportsCreate an export

Documentation

/

Type to filter the docs by title or path.

Bulk exportsEndpoint 111 of 116

Create an export

POST

/v2/exports

Plan
Business
Auth
Bearer dsa_live_…
Parameters
None
Returns
Export
Season exports guide

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.

Plan access

Requires the Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

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

01Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -X POST -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/exports"

02Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Export
Example call and response
$ curl -X POST -H "Authorization: Bearer dsa_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": [] } }

03Errors

  • 404not_found

    the league does not exist, or the season does not belong to it

  • 429export_limit

    the allowance of 20 exports per UTC day has been used up

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code