GET Fixtures by Date Range for Team

GET Fixtures by Date Range for Team

https://soccer.sportmonks.com/api/v2.0/fixtures/between/{start_date}/{end_date}/{team_ID}

Endpoint details
Authorization	API Key
Pagination	YES
Allowed nested includes	10

Parameters

Available parameters
page	The number of the page you want to browse. Can be used by adding &page= etc to your request url.
include	Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.
fixtures	Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures= etc to your request url.
bookmakers	Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers= etc to your request url.
markets	Filter on a list of market id's separated by comma. Can be used by adding &markets= etc to your request url.
leagues	Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.
status	Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status= etc to your request url.

Include 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

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

Request

https://soccer.sportmonks.com/api/v2.0/fixtures/between/2021-08-04/2021-09-04/9?api_token={API_TOKEN}

Response

 "data": [
        {
            "id": 18125073,
            "league_id": 23,
            "season_id": 18344,
            "stage_id": null,
            "round_id": null,
            "group_id": null,
            "aggregate_id": null,
            "venue_id": 1315,
            "referee_id": 15294,
            "localteam_id": 42,
            "visitorteam_id": 9,
            "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": "2021-08-07 16:15:00",
                    "date": "2021-08-07",
                    "time": "16:15:00",
                    "timestamp": 1628352900,
                    "timezone": "UTC"
                },
                "minute": null,
                "second": null,
                "added_time": null,
                "extra_minute": null,
                "injury_time": null
            },
            "coaches": {
                "localteam_coach_id": 896460,
                "visitorteam_coach_id": 455361
            },
            "standings": {
                "localteam_position": 1,
                "visitorteam_position": 2
            },
            "assistants": {
                "first_assistant_id": 12090,
                "second_assistant_id": 12096,
                "fourth_official_id": 14814
            },
            "leg": "1/1",
            "colors": null,
            "deleted": false,
            "is_placeholder": false
        },
        {
            "id": 18138611,
            "league_id": 8,
            "season_id": 18378,
            "stage_id": 77453700,
            "round_id": 247583,
            "group_id": null,
            "aggregate_id": null,
            "venue_id": 281313,
            "referee_id": null,
            "localteam_id": 6,
            "visitorteam_id": 9,
            "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": "2021-08-15 15:30:00",
                    "date": "2021-08-15",
                    "time": "15:30:00",
                    "timestamp": 1629041400,
                    "timezone": "UTC"
                },
                "minute": null,
                "second": null,
                "added_time": null,
                "extra_minute": null,
                "injury_time": null
            },
            "coaches": {
                "localteam_coach_id": null,
                "visitorteam_coach_id": null
            },
            "standings": {
                "localteam_position": null,
                "visitorteam_position": null
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_official_id": null
            },
            "leg": "1/1",
            "colors": null,
            "deleted": false,
            "is_placeholder": false
        },

Field Description