Fixtures by Date Range

GET https://soccer.sportmonks.com/api/v2.0/fixtures/between/:STARTDATE/:ENDATE

Introduction

The Fixture endpoint provides information about Games in particular Leagues. There are always 2 teams involved in a Fixture. For many customers, Fixtures is the main endpoint for their app/website. Be aware your access is limited to Fixtures of Leagues, available in the Plan you are subscribed to.

Responses of the Fixture endpoint are highly customizable, because there are many Includes available to extend the response. Requests often start with the Includes localTeam and VisitorTeam. Events, Stats, Lineups, Comment, Trends etc. are often added as well.

Pagination

YES - Indicates if this endpoint contains pagination.

Nested Includes

10 - You can add a maximum of 10 levels of nested includes.

Includes Options

localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news

Request Params

RESPONSES

status: OK

{"data":[{"id":16475287,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194968,"group_id":null,"aggregate_id":null,"venue_id":8909,"referee_id":14859,"localteam_id":53,"visitorteam_id":338,"winner_team_id":53,"weather_report":{"code":"clouds","type":"few clouds","icon":"https://cdn.sportmonks.com/images/weather/02d.png","temperature":{"temp":59.94,"unit":"fahrenheit"},"temperature_celcius":{"temp":15.5,"unit":"celcius"},"clouds":"20%","humidity":"67%","pressure":1014,"wind":{"speed":"10.29 m/s","degree":300},"coordinates":{"lat":55.87,"lon":-4.26},"updated_at":"2020-08-02T17:15:04.814798Z"},"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":true,"formations":{"localteam_formation":"4-2-3-1","visitorteam_formation":"4-4-2"},"scores":{"localteam_score":5,"visitorteam_score":1,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":"2-1","ft_score":"5-1","et_score":null,"ps_score":null},"time":{"status":"FT","starting_at":{"date_time":"2020-08-02 15:30:00","date":"2020-08-02","time":"15:30:00","timestamp":1596382200,"timezone":"UTC"},"minute":90,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":1467946,"visitorteam_coach_id":30082158},"standings":{"localteam_position":1,"visitorteam_position":12},"assistants":{"first_assistant_id":12118,"second_assistant_id":17249,"fourth_official_id":15815},"leg":"1/1","colors":{"localteam":{"color":"#007848","kit_colors":"#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"},"visitorteam":{"color":"#0046A8","kit_colors":"#0046A8,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0046A8"}},"deleted":false},{"id":16475288,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194968,"group_id":null,"aggregate_id":null,"venue_id":8908,"referee_id":14468,"localteam_id":246,"visitorteam_id":309,"winner_team_id":246,"weather_report":{"code":"clouds","type":"scattered clouds","icon":"https://cdn.sportmonks.com/images/weather/03n.png","temperature":{"temp":56.66,"unit":"fahrenheit"},"temperature_celcius":{"temp":13.7,"unit":"celcius"},"clouds":"40%","humidity":"67%","pressure":1013,"wind":{"speed":"13.87 m/s","degree":240},"coordinates":{"lat":57.6,"lon":-4.43},"updated_at":"2020-08-03T20:30:09.846087Z"},"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":true,"formations":{"localteam_formation":"4-3-3","visitorteam_formation":"4-2-3-1"},"scores":{"localteam_score":1,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":"1-0","ft_score":"1-0","et_score":null,"ps_score":null},"time":{"status":"FT","starting_at":{"date_time":"2020-08-03 18:45:00","date":"2020-08-03","time":"18:45:00","timestamp":1596480300,"timezone":"UTC"},"minute":90,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":172638,"visitorteam_coach_id":524215},"standings":{"localteam_position":4,"visitorteam_position":11},"assistants":{"first_assistant_id":20635,"second_assistant_id":16670,"fourth_official_id":14855},"leg":"1/1","colors":{"localteam":{"color":"#022857","kit_colors":"#002B87,#022857,#F0F0F0,#C40010,#1B223E,#1B223E,#022857"},"visitorteam":{"color":"#FDBD0F","kit_colors":"#FDBD0F,#FDBD0F,#832034,#FDBD0F,#5C8FAE,#FFDF1B,#940014"}},"deleted":false},{"id":16475289,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":219,"referee_id":14859,"localteam_id":734,"visitorteam_id":273,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-08 11:30:00","date":"2020-08-08","time":"11:30:00","timestamp":1596886200,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":1742,"visitorteam_coach_id":896462},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":17848,"second_assistant_id":12241,"fourth_official_id":18439},"leg":"1/1","colors":null,"deleted":false},{"id":16475290,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":14509,"referee_id":14853,"localteam_id":338,"visitorteam_id":246,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-08 14:00:00","date":"2020-08-08","time":"14:00:00","timestamp":1596895200,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":30082158,"visitorteam_coach_id":172638},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":12127,"second_assistant_id":14794,"fourth_official_id":17259},"leg":"1/1","colors":null,"deleted":false},{"id":16475291,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":8943,"referee_id":14855,"localteam_id":258,"visitorteam_id":66,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-08 14:00:00","date":"2020-08-08","time":"14:00:00","timestamp":1596895200,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":22145896,"visitorteam_coach_id":171828},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":15817,"second_assistant_id":20114,"fourth_official_id":17266},"leg":"1/1","colors":null,"deleted":false},{"id":16475292,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":8922,"referee_id":17847,"localteam_id":309,"visitorteam_id":282,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-08 14:00:00","date":"2020-08-08","time":"14:00:00","timestamp":1596895200,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":524215,"visitorteam_coach_id":896498},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":12772,"second_assistant_id":18758,"fourth_official_id":20116},"leg":"1/1","colors":null,"deleted":false},{"id":16475293,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":8914,"referee_id":14466,"localteam_id":62,"visitorteam_id":496,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-09 14:00:00","date":"2020-08-09","time":"14:00:00","timestamp":1596981600,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":50,"visitorteam_coach_id":1621},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":12122,"second_assistant_id":18749,"fourth_official_id":14795},"leg":"1/1","colors":null,"deleted":false},{"id":16475294,"league_id":501,"season_id":17141,"stage_id":77447501,"round_id":194969,"group_id":null,"aggregate_id":null,"venue_id":8906,"referee_id":15815,"localteam_id":180,"visitorteam_id":53,"winner_team_id":null,"weather_report":null,"commentaries":false,"attendance":null,"pitch":null,"details":null,"neutral_venue":false,"winning_odds_calculated":false,"formations":{"localteam_formation":null,"visitorteam_formation":null},"scores":{"localteam_score":0,"visitorteam_score":0,"localteam_pen_score":null,"visitorteam_pen_score":null,"ht_score":null,"ft_score":null,"et_score":null,"ps_score":null},"time":{"status":"NS","starting_at":{"date_time":"2020-08-09 15:30:00","date":"2020-08-09","time":"15:30:00","timestamp":1596987000,"timezone":"UTC"},"minute":null,"second":null,"added_time":null,"extra_minute":null,"injury_time":null},"coaches":{"localteam_coach_id":37382888,"visitorteam_coach_id":1467946},"standings":{"localteam_position":null,"visitorteam_position":null},"assistants":{"first_assistant_id":14467,"second_assistant_id":18757,"fourth_official_id":14468},"leg":"1/1","colors":null,"deleted":false}],"meta":{"subscription":{"started_at":{"date":"2019-09-02 09:52:14.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":{"date":"2019-09-16 09:52:10.000000","timezone_type":3,"timezone":"UTC"},"ends_at":null},"plan":{"name":"PostMan Plan","price":"25.00","request_limit":"2000,60"},"sports":[{"id":1,"name":"Soccer","current":true}],"pagination":{"total":8,"count":8,"per_page":100,"current_page":1,"total_pages":1,"links":{}}}}