OPEN NAVIGATION MENU

Expand

Expand the API response

Many endpoints allow you to request additional information as an expanded response by using the expand request argument. Values that can be included in the expand argument are noted in the documentation in the arguments list.

You can also expand recursively by specifying nested fields after a dot. For example, requesting current_season.next_fixtures on the Leagues endpoint will enrich the league details with the current season object and then the season object with the details of the future fixture of that Season.

Expansions have a maximum depth of three levels (so for example, when listing leagues, current_season.next_fixtures.home_team is the deepest allowed).

You can expand the response with multiple objects at once by separating the expand attribute values by a coma (so for example, when listing fixture, home_team,away_team.next_fixtures,h2h is a valid expand value).