GETFixtures by round
Every match of a round, optionally narrowed to a team.
/v2.2/fixtures/ with t=round
Try it in the interactive referenceAll Fixtures operations
Request
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=round&round_id=1994- Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
round_id | yes | Round ID. | 1994 |
team_id | no | Team ID. | 111 |
include | no | Comma-separated datasets to embed in the response, without spaces. Supported values: events, stats, broadcast, odds_prematch, odds_inplay. See the includes section. | events,stats |
utc | no | UTC offset applied to returned date/time values; time.timezone reports it, for example UTC+4.5. Decimal offsets are accepted and invalid values fall back to UTC. | 2 |
lang | no | Language code for localized names, for example en, es, de, fr, it, pt, tr, pl, ko or zh. Verified on country, continent and league catalogue names; match and statistics payloads are not translated. | en |
odds_format | no | Odds format on odds datasets: decimal (default), fractional or american. | decimal |
Example response
{
"data": [
{
"id": 31162,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "1994",
"round_name": "1",
"season_id": "406",
"season_name": "19/20",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "222",
"group_name": "Bundesliga",
"aggregate_id": null,
"winner_team_id": "0",
"venue_id": "1446",
"leg": null,
"week": "33",
"deleted": "0",
"related_id": null,
"info": null,
"attendance": null,
"time": {
"datetime": "2019-08-16 18:30:00",
"date": "2019-08-16",
"time": "18:30:00",
"minute": 90,
"timestamp": 1565980200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 111,
"name": "FC Bayern Munich",
"short_code": "BMU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "5992",
"kit_colors": {
"home_main_color": "#f23a3a",
"home_second_color": "#ffffff",
"home_number_color": "#ffffff",
"home_gk_main_color": "#69d68d",
"home_gk_second_color": "#83e79e",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 2806,
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": null,
"coach_id": "256",
"kit_colors": {
"away_main_color": "#f4f6fa",
"away_second_color": "#001fb8",
"away_number_color": "#0e59ca",
"away_gk_main_color": "#43beec",
"away_gk_second_color": "#7366c0",
"away_gk_number_color": "#f1efef"
}
}
},
"league": {
"id": 594,
"name": "Bundesliga",
"type": "Bundesliga",
"country_id": "4",
"country_name": "Germany",
"country_code": "de",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "1-2",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 0,
"away_position": 0
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 1
},
"weather_report": {
"desc": "clear/sunny",
"temp": {
"celsius": 22,
"fahrenheit": 71.6
},
"wind": {
"kmph": null,
"miles": 0,
"direction": "SW"
},
"humidity_percent": 54,
"pressure": 1014
}
},
{
"id": 31163,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "1994",
"round_name": "1",
"season_id": "406",
"season_name": "19/20",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "222",
"group_name": "Bundesliga",
"aggregate_id": null,
"winner_team_id": "114",
"venue_id": "1386",
"leg": null,
"week": "33",
"deleted": "0",
"related_id": null,
"info": null,
"attendance": null,
"time": {
"datetime": "2019-08-17 13:30:00",
"date": "2019-08-17",
"time": "13:30:00",
"minute": 90,
"timestamp": 1566048600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 114,
"name": "Bayer 04 Leverkusen",
"short_code": "LEV",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
"form": null,
"coach_id": "5242",
"kit_colors": {
"home_main_color": "#3b373c",
"home_second_color": "#39393f",
"home_number_color": "#ffffff",
"home_gk_main_color": "#f5903a",
"home_gk_second_color": "#f5903a",
"home_gk_number_color": "#f5f9fa"
}
},
"away": {
"id": 2807,
"name": "SC Paderborn 07",
"short_code": "PAD",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2807.png",
"form": null,
"coach_id": "3225",
"kit_colors": {
"away_main_color": "#ffffff",
"away_second_color": "#308ad1",
"away_number_color": "#000000",
"away_gk_main_color": "#f52c4e",
"away_gk_second_color": "#f62a53",
"away_gk_number_color": "#0d3d82"
}
}
},
"league": {
"id": 594,
"name": "Bundesliga",
"type": "Bundesliga",
"country_id": "4",
"country_name": "Germany",
"country_code": "de",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "2",
"ht_score": "2-2",
"ft_score": "3-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 0,
"away_position": 0
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 0,
"has_standings": 1
},
"weather_report": {
"desc": "partly cloudy",
"temp": {
"celsius": 20,
"fahrenheit": 68
},
"wind": {
"kmph": 20,
"miles": 12.4,
"direction": "SSW"
},
"humidity_percent": 71,
"pressure": 1008
}
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 9,
"total": 9,
"msg": ""
}
}