Skip to content
datasportsAPI

Bulk exportsExport status

Documentation

/

Type to filter the docs by title or path.

Bulk exportsEndpoint 112 of 116

Export status

GET

/v2/exports/{id}

Plan
Business
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
Export
Try in Playground Season exports guide

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.

Plan access

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

01Parameters

  • idpathRequired

    export id issued by DataSportsAPI, a positive integer

02Request

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 -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/exports/{id}"

03Response

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

data
Export
Example response
{ "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" } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code