# POST /v2/exports

Group: Bulk exports

Start an export of one league season. Body (JSON): league (our id), season (an id from /v2/leagues/{id}/seasons), format — json (default: one season.json with league, season, rounds, every fixture, standings, top players and top teams as the endpoints serve them), csv or parquet (two flat tables, fixtures and standings). Answers 202 with the export, status pending.

Plans: Business only (other plans get 403 endpoint_not_in_plan).

Note: Fixtures come from the season’s rounds: a competition the source does not organize in rounds (NBA and NHL regular seasons) exports no fixtures, and the export’s error field names anything that could not be read (“not included: topPlayers”). A postponed match that was replayed later can appear twice, as the source lists it: the postponed fixture and the played one, under different ids (Premier League 25/26: 381 fixtures, one postponed). CSV / Parquet columns — 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 — no such league, or the season is not one of the league’s
- 429 export_limit — 20 exports a UTC day used

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -X POST -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/exports"
```

TypeScript:

```ts
const { data, meta } = await client.exports.create({ league, season });
```

Python:

```python
res = client.exports.create(league=league, season=season)
```

Go:

```go
res, err := client.Exports.Create(ctx, &sportsapi.ExportsCreateParams{League: league, Season: season})
```

CLI:

```bash
$ sportsapi exports create --league <league> --season <season>
```

## Example response

```json
$ curl -X POST -H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" \
    -d '{ "league": 17, "season": 61627, "format": "parquet" }' https://api.sportsapi.app/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": [] } }
```

---

Base URL: https://api.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/exports/create · All docs: https://sportsapi.app/markdown/en/docs.md