Fixtures

Introduction

The response of this endpoint is limited to the leagues that are assigned to your subscription. Fixtures represent a game played in a particular league. A Fixture is played between 2 teams. Without using includes this will return information about the current status of 1 or more games. You can enrich the the game by adding the proper includes.

{tip} If you want to include odds into your response it is wise to set the Accept-Encoding: gzip, deflate header in your request since responses my sometimes become very big and can cause errors.

Fixtures Between 2 Dates

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/fixtures/between/{from}/{to}
Headers Accept: application/json
Paginated Yes, 100 records per page.
Includes localTeam, visitorTeam, substitutions, goals, cards, other, corners, lineup, bench, sidelined, stats, comments, tvstations, highlights, league, season, round, stage, referee, events, venue, odds, flatOdds, inplay, localCoach, visitorCoach,group, trends
Date Format YYYY-MM-DD
Include Limit 3, The maximum level of includes that are allowed
Data Features All data features
Parameters leagues * a comma separated list of leagues ids to only returned fixtures for those leagues

Please note that data returned from this endpoint is cached so do NOT use this endpoint to get livescores.

Fixtures Between 2 Dates For Team

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/fixtures/between/{from}/{to}/{team_id}
Headers Accept: application/json
Paginated Yes, 100 records per page.
Includes localTeam, visitorTeam, substitutions, goals, cards, other, corners, lineup, bench, sidelined, stats, comments, tvstations, highlights, league, season, round, stage, referee, events, venue, odds, flatOdds, inplay, localCoach, visitorCoach,group, trends
Date Format YYYY-MM-DD
Include Limit 3, The maximum level of includes that are allowed
Data Features All data features
Parameters leagues * a comma separated list of leagues ids to only returned fixtures for those leagues

Please note that data returned from this endpoint is cached so do NOT use this endpoint to get livescores.

Fixtures For Specific Date

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/fixtures/date/{date}
Headers Accept: application/json
Paginated Yes, 100 records per page.
Includes localTeam, visitorTeam, substitutions, goals, cards, other, corners, lineup, bench, sidelined, stats, comments, tvstations, highlights, league, season, round, stage, referee, events, venue, odds, flatOdds, inplay, localCoach, visitorCoach,group, trends
Date Format YYYY-MM-DD
Include Limit 3, The maximum level of includes that are allowed
Data Features All data features

Please note that data returned from this endpoint is cached so do NOT use this endpoint to get livescores.

Fixture By Id

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/fixtures/{id}
Headers Accept: application/json
Paginated No, This endpoint is not paginated.
Includes localTeam, visitorTeam, substitutions, goals, cards, other, corners, lineup, bench, sidelined, stats, comments, tvstations, highlights, league, season, round, stage, referee, events, venue, odds, flatOdds, inplay, localCoach, visitorCoach,group, trends
Include Limit 10, The maximum level of includes that are allowed
Data Features All data features

{tip} Please note that data returned from this endpoint might be cached so do NOT use this endpoint to get livescores.

Multiple Fixtures By Id

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/fixtures/multi/{id_list}
Headers Accept: application/json
Paginated No, This endpoint is not paginated.
Includes localTeam, visitorTeam, substitutions, goals, cards, other, corners, lineup, bench, sidelined, stats, comments, tvstations, highlights, league, season, round, stage, referee, events, venue, odds, flatOdds, inplay, localCoach, visitorCoach,group, trends
Include Limit 10, The maximum level of includes that are allowed
Data Features All data features

{tip} You can pass a comma separated list of of ids. This endpoint is limited to 25 games at once.