BoxToBox API
Matching APICompetitions

List seasons for a competition with provider keys

GET
/competitions/{id}/seasons

Returns the competition mapping (same shape as /matching/competitions) plus a seasons array, as a single bare object (not wrapped in matching). Each season carries the Transfermarkt key (<competition_id>/<season_id>), a display name, and the season key of every requested target provider that covers this competition. Seasons the requested target providers have no data for are left out.

from defaults to transfermarkt when omitted. Target providers that carry season data: wyscout, skillcorner, statsbomb, sofascore, impect.

Example request: GET /competitions/PL1/seasons?to=statsbomb,skillcorner&token=XXX

Path Parameters

id*string

Competition id in the source provider

Query Parameters

from?string

Source provider key (default: transfermarkt)

to*string

Comma-separated target provider keys

Response Body

application/json

application/json

application/json

application/json

token<token>

In: query

curl -X GET "https://example.com/competitions/string/seasons?to=string"
{  "name": "string",  "transfermarkt": "string",  "seasons": [    {      "transfermarkt": "string",      "name": "string"    }  ]}