Fixture with events
GET https://soccer.sportmonks.com/api/v2.0/fixtures/:FIXTURE_ID?include=events.player
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.
The events include will provide you with all the key match events like goals, cards, substitutions and more.
Furthermore, we used the nested events.player to include some basic player information.
Of course, you can also use this on the other fixtures and livescores endpoints.
Pagination
NO - 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
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
markets | null | Filter odds based on a comma separated list of market ids. | |
bookmakers | null | Filter odds based on a comma separated list of bookmaker ids. | |
include | string | Enrich the API with more data and/or nested includes |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
| `` | null |
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,"events":{"data":[{"id":16475287001,"team_id":"338","type":"yellowcard","var_result":null,"fixture_id":16475287,"player_id":174161,"player_name":"S. Martin","related_player_id":null,"related_player_name":null,"minute":17,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":174161,"team_id":338,"country_id":1161,"position_id":3,"common_name":"S. Martin","display_name":"Scott Martin","fullname":"Scott Martin","firstname":"Scott","lastname":"Martin","nationality":"Scotland","birthdate":"01/04/1997","birthcountry":"Scotland","birthplace":"Glasgow","height":null,"weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/17/174161.png"}}},{"id":16475287002,"team_id":"53","type":"goal","var_result":null,"fixture_id":16475287,"player_id":96792,"player_name":"O. Édouard","related_player_id":173080,"related_player_name":"G. Taylor","minute":20,"extra_minute":null,"reason":null,"injuried":null,"result":"1-0","on_pitch":true,"player":{"data":{"player_id":96792,"team_id":53,"country_id":17,"position_id":4,"common_name":"O. Édouard","display_name":"Odsonne Édouard","fullname":"Odsonne Édouard","firstname":"Odsonne","lastname":"Édouard","nationality":"France","birthdate":"16/01/1998","birthcountry":"Guyana","birthplace":"Kourou","height":"187 cm","weight":"83 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/24/96792.png"}}},{"id":16475287003,"team_id":"53","type":"goal","var_result":null,"fixture_id":16475287,"player_id":8403182,"player_name":"J. Frimpong","related_player_id":173080,"related_player_name":"G. Taylor","minute":31,"extra_minute":null,"reason":null,"injuried":null,"result":"2-0","on_pitch":true,"player":{"data":{"player_id":8403182,"team_id":3321,"country_id":462,"position_id":3,"common_name":"J. Frimpong","display_name":"Jeremie Frimpong","fullname":"Jeremie Frimpong","firstname":"Jeremie","lastname":"Frimpong","nationality":"England","birthdate":"10/12/2000","birthcountry":"England","birthplace":null,"height":null,"weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/14/8403182.png"}}},{"id":16475287004,"team_id":"338","type":"own-goal","var_result":null,"fixture_id":16475287,"player_id":32761,"player_name":"C. Jullien","related_player_id":null,"related_player_name":null,"minute":34,"extra_minute":null,"reason":null,"injuried":null,"result":"2-1","on_pitch":true,"player":{"data":{"player_id":32761,"team_id":53,"country_id":17,"position_id":2,"common_name":"C. Jullien","display_name":"Christopher Jullien","fullname":"Christopher Jullien","firstname":"Christopher","lastname":"Jullien","nationality":"France","birthdate":"22/03/1993","birthcountry":"France","birthplace":"Lagny-sur-Marne","height":"196 cm","weight":"88 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/25/32761.png"}}},{"id":16475287005,"team_id":"338","type":"yellowcard","var_result":null,"fixture_id":16475287,"player_id":173774,"player_name":"R. Callachan","related_player_id":null,"related_player_name":null,"minute":36,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":173774,"team_id":338,"country_id":1161,"position_id":3,"common_name":"R. Callachan","display_name":"Ross Callachan","fullname":"Ross Callachan","firstname":"Ross","lastname":"Callachan","nationality":"Scotland","birthdate":"04/09/1993","birthcountry":"England","birthplace":"London","height":"178 cm","weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/14/173774.png"}}},{"id":16475287006,"team_id":"338","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":111635,"player_name":"M. Ogkmpoe","related_player_id":173093,"related_player_name":"R. Hughes","minute":42,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":111635,"team_id":338,"country_id":716,"position_id":4,"common_name":"M. Ogboe","display_name":"Marios Ogboe","fullname":"Marios Ogboe","firstname":"Marios","lastname":"Ogboe","nationality":"Nigeria","birthdate":"10/10/1994","birthcountry":"Greece","birthplace":null,"height":null,"weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/19/111635.png"}}},{"id":16475287007,"team_id":"53","type":"goal","var_result":null,"fixture_id":16475287,"player_id":96792,"player_name":"O. Édouard","related_player_id":172104,"related_player_name":"J. Forrest","minute":49,"extra_minute":null,"reason":null,"injuried":null,"result":"3-1","on_pitch":true,"player":{"data":{"player_id":96792,"team_id":53,"country_id":17,"position_id":4,"common_name":"O. Édouard","display_name":"Odsonne Édouard","fullname":"Odsonne Édouard","firstname":"Odsonne","lastname":"Édouard","nationality":"France","birthdate":"16/01/1998","birthcountry":"Guyana","birthplace":"Kourou","height":"187 cm","weight":"83 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/24/96792.png"}}},{"id":16475287008,"team_id":"53","type":"goal","var_result":null,"fixture_id":16475287,"player_id":96792,"player_name":"O. Édouard","related_player_id":null,"related_player_name":null,"minute":53,"extra_minute":null,"reason":null,"injuried":null,"result":"4-1","on_pitch":true,"player":{"data":{"player_id":96792,"team_id":53,"country_id":17,"position_id":4,"common_name":"O. Édouard","display_name":"Odsonne Édouard","fullname":"Odsonne Édouard","firstname":"Odsonne","lastname":"Édouard","nationality":"France","birthdate":"16/01/1998","birthcountry":"Guyana","birthplace":"Kourou","height":"187 cm","weight":"83 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/24/96792.png"}}},{"id":16475287009,"team_id":"338","type":"yellowcard","var_result":null,"fixture_id":16475287,"player_id":111635,"player_name":"M. Ogkmpoe","related_player_id":null,"related_player_name":null,"minute":55,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":111635,"team_id":338,"country_id":716,"position_id":4,"common_name":"M. Ogboe","display_name":"Marios Ogboe","fullname":"Marios Ogboe","firstname":"Marios","lastname":"Ogboe","nationality":"Nigeria","birthdate":"10/10/1994","birthcountry":"Greece","birthplace":null,"height":null,"weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/19/111635.png"}}},{"id":16475287010,"team_id":"53","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":129858,"player_name":"O. Ntcham","related_player_id":150759,"related_player_name":"M. Elyounoussi","minute":70,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":129858,"team_id":44,"country_id":17,"position_id":3,"common_name":"J. Ntcham","display_name":"Olivier Ntcham","fullname":"Jules Olivier Ntcham","firstname":"Jules Olivier","lastname":"Ntcham","nationality":"France","birthdate":"09/02/1996","birthcountry":"France","birthplace":"Longjumeau","height":"180 cm","weight":"80 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/2/129858.png"}}},{"id":16475287011,"team_id":"338","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":91670,"player_name":"C. Trafford","related_player_id":173774,"related_player_name":"R. Callachan","minute":70,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":91670,"team_id":338,"country_id":1004,"position_id":3,"common_name":"C. Trafford","display_name":"Charlie Trafford","fullname":"Charlie Trafford","firstname":"Charlie","lastname":"Trafford","nationality":"Canada","birthdate":"24/05/1992","birthcountry":"Canada","birthplace":"Calgary","height":"192 cm","weight":"82 kg","image_path":"https://cdn.sportmonks.com/images/soccer/placeholder.png"}}},{"id":16475287012,"team_id":"338","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":787013,"player_name":"C. McKenna","related_player_id":12515,"related_player_name":"H. Odoffin","minute":70,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":787013,"team_id":339,"country_id":1161,"position_id":3,"common_name":"C. McKenna","display_name":"Ciaran McKenna","fullname":"Ciaran McKenna","firstname":"Ciaran","lastname":"McKenna","nationality":"Scotland","birthdate":"25/03/1998","birthcountry":"Scotland","birthplace":null,"height":null,"weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/5/787013.png"}}},{"id":16475287013,"team_id":"53","type":"yellowcard","var_result":null,"fixture_id":16475287,"player_id":173080,"player_name":"G. Taylor","related_player_id":null,"related_player_name":null,"minute":85,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":173080,"team_id":53,"country_id":1161,"position_id":2,"common_name":"G. Taylor","display_name":"Greg Taylor","fullname":"Greg Taylor","firstname":"Greg","lastname":"Taylor","nationality":"Scotland","birthdate":"05/11/1997","birthcountry":"Scotland","birthplace":null,"height":"173 cm","weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/24/173080.png"}}},{"id":16475287014,"team_id":"53","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":61665,"player_name":"H. Elhamed","related_player_id":8403182,"related_player_name":"J. Frimpong","minute":86,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":61665,"team_id":53,"country_id":802,"position_id":2,"common_name":"H. Elhamed","display_name":"Hatem Abd Elhamed","fullname":"Hatem Abd Elhamed","firstname":"Hatem Abd","lastname":"Elhamed","nationality":"Israel","birthdate":"18/03/1991","birthcountry":"Israel","birthplace":"Kfar Manda","height":"188 cm","weight":"80 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/1/61665.png"}}},{"id":16475287015,"team_id":"53","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":35699874,"player_name":"K. Dembélé","related_player_id":172752,"related_player_name":"R. Christie","minute":86,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":35699874,"team_id":53,"country_id":1161,"position_id":4,"common_name":"K. Dembélé","display_name":"Karamoko Dembélé","fullname":"Karamoko Kader Dembélé","firstname":"Karamoko Kader","lastname":"Dembélé","nationality":"Scotland","birthdate":"22/02/2003","birthcountry":"England","birthplace":"London","height":"160 cm","weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/2/35699874.png"}}},{"id":16475287016,"team_id":"53","type":"substitution","var_result":null,"fixture_id":16475287,"player_id":156822,"player_name":"P. Klimala","related_player_id":96792,"related_player_name":"O. Édouard","minute":86,"extra_minute":null,"reason":null,"injuried":null,"result":null,"on_pitch":true,"player":{"data":{"player_id":156822,"team_id":53,"country_id":2,"position_id":4,"common_name":"P. Klimala","display_name":"Patryk Klimala","fullname":"Patryk Klimala","firstname":"Patryk","lastname":"Klimala","nationality":"Poland","birthdate":"05/08/1998","birthcountry":"Poland","birthplace":"Świdnica","height":"183 cm","weight":"76 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/22/156822.png"}}},{"id":16475287017,"team_id":"53","type":"goal","var_result":null,"fixture_id":16475287,"player_id":156822,"player_name":"P. Klimala","related_player_id":32761,"related_player_name":"C. Jullien","minute":90,"extra_minute":null,"reason":null,"injuried":null,"result":"5-1","on_pitch":true,"player":{"data":{"player_id":156822,"team_id":53,"country_id":2,"position_id":4,"common_name":"P. Klimala","display_name":"Patryk Klimala","fullname":"Patryk Klimala","firstname":"Patryk","lastname":"Klimala","nationality":"Poland","birthdate":"05/08/1998","birthcountry":"Poland","birthplace":"Świdnica","height":"183 cm","weight":"76 kg","image_path":"https://cdn.sportmonks.com/images/soccer/players/22/156822.png"}}}]}},"meta":{"subscription":{"started_at":{"date":"2017-03-20 21:02:56.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":null,"ends_at":null},"plan":{"name":"Free Plan","price":"0.00","request_limit":"3,1"},"sports":[{"id":1,"name":"Soccer","current":true},{"id":6,"name":"Cricket","current":false}]}}