Qodex.ai

Fixtures by Date Range for Team

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

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

KeyDatatypeRequiredDescription
leaguesnullA comma separated list of leagues. Max 25 ids can be included.
marketsnullFilter odds based on a comma separated list of market ids.
bookmakersnullFilter odds based on a comma separated list of bookmaker ids.
statusnullFilter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page.
includenullEnrich the API with more data and/or nested includes

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":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":2,"count":2,"per_page":100,"current_page":1,"total_pages":1,"links":{}}}}