Documentation

Quickstart / API Reference / Libraries

Overview


On June 27, 2018 I (finally) released the new v2 API. The new API comes with a lot more competitions (144) and data (incl. live results, lineups/subs, goalscorers, bookings, squads).

Some useful links:

The old v1 API will remain available for the foreseeable future, but I do recommend you migrate to the new v2 API ASAP. The v1 API documentation can still be accessed.

Available resources

See all available endpoints underneath. See Filtering table at the very bottom to see how to pass filters in adequate format.
(Sub)Resource Action URI Filters Sample
Competition List all available competitions. /v2/competitions/ areas={areas} Open
Competition List one particular competition. /v2/competitions/2000 Open
Team List all teams for a particular competition. /v2/competitions/{id}/teams stage={STAGE} Open
Standings Show Standings for a particular competition. /v2/competitions/{id}/standings Open
Match List all matches for a particular competition. /v2/competitions/{id}/matches dateFrom={DATE}
dateTo={DATE}
stage={STAGE}
status={STATUS}
matchday={MATCHDAY}
group={GROUP}
Open
Match List matches across (a set of) competitions. /v2/matches competitions={competitionIds}
dateFrom={DATE}
dateTo={DATE}
status={STATUS}
Open
Match Show one particular match. /v2/matches/{id} Open
Match Show all matches for a particular team. /v2/teams/{id}/matches/ dateFrom={DATE}
dateTo={DATE}
status={STATUS}
venue={VENUE}
Open
Team Show one particular team. /v2/teams/{id} - Open
Areas List all available areas. /v2/areas/ - Open
Areas List one particular area. /v2/areas/{id} - Open

Filters and their data types

Filter Type Description / Possible values
id Integer /[0-9]+/ The id of a resource.
matchday Integer /[1-4]*[0-9]*/
status String /[A-Z]+/ [SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELED]
venue String /[A-Z]+/ Defines the venue (type). HOME | AWAY
dateFrom / dateTo String /YYYY-MM-dd/ e.g. 2018-06-22
stage String /[A-Z]+/ Check the season node for available stages for a particular competition/season.