Fixtures

Get upcoming, live, or historic matches for a team or league, preview an upcoming fixture with head-to-head history, or fetch full match details including lineups, events, and statistics.

Tools

Tool	Description
get_matches	Upcoming, live, or historic fixtures for a team or league
get_match_preview	Fixture info plus the last 5 head-to-head results
get_fixture_details	Detailed match data with optional lineups, events, and statistics

get_matches

Parameters

Parameter	Type	Required	Description
id	integer	Yes	Sportmonks team ID or league ID
type	string	Yes	team or league
timeframe	string	No	upcoming (default), live, or historic

Limits:

• upcoming - next 14 days, max 20 fixtures

• historic - last 30 days, max 20 fixtures

• live - max 20 fixtures

get_match_preview

Returns a fixture summary plus the last 5 head-to-head matches between the two teams.

Only works for fixtures that have not yet started. Use get_matches with timeframe: upcoming to find a valid fixture ID.

Parameters

Parameter	Type	Required	Description
id	integer	Yes	Sportmonks fixture ID

get_fixture_details

Returns base fixture data plus any optional expansions you request.

Parameters

Parameter	Type	Required	Description
fixture_id	integer	Yes	Sportmonks fixture ID
includes	array	No	Any of: lineups, events, statistics

Base response includes both teams, scoreline, state, and league.

Optional expansions:

• lineups - starting XI and substitutes. Each player includes name, position (resolved label), detailed position, jersey number, and lineup type (starter/substitute)

• events - goals, cards, and substitutions in chronological order

• statistics - team stats (shots, possession, corners, etc.) keyed by type name

Example prompts

• Show me Arsenal's upcoming fixtures for the next two weeks

• What were Liverpool's results over the last 30 days?

• Are there any live matches right now?

• Give me a preview for fixture 19135697 - include the H2H record

• Get the full details for fixture 19135697 including lineups and statistics