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).