GETMatches by multiple IDs
Several matches in one request, for example to refresh the matches shown on screen.
/v2.2/fixtures/ with t=sort
Try it in the interactive referenceAll Fixtures operations
Request
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=sort&ids=2589310,2589313&include=events- Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
ids | yes | Comma-separated match IDs, without spaces. | 2589310,2589313 |
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 |
Example response
{
"data": [
{
"id": 2589310,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "216028",
"round_name": "2",
"season_id": "21033",
"season_name": "26/27",
"stage_id": "3461",
"stage_name": "Regular Season - Premier League 26/27",
"group_id": "13583",
"group_name": "Premier League 26/27",
"aggregate_id": null,
"winner_team_id": "20",
"venue_id": "1166",
"leg": null,
"week": "35",
"deleted": "0",
"related_id": null,
"info": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 13:00:00",
"date": "2026-08-30",
"time": "13:00:00",
"minute": 90,
"timestamp": 1788094800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 20,
"name": "Chelsea FC",
"short_code": "CFC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/20.png",
"form": null,
"coach_id": "12680",
"kit_colors": {
"home_main_color": "#1532c1",
"home_second_color": "#1532c1",
"home_number_color": "#f7d444",
"home_gk_main_color": "#1d5160",
"home_gk_second_color": "#121212",
"home_gk_number_color": "#fcfcfc"
}
},
"away": {
"id": 12,
"name": "Brighton & Hove Albion",
"short_code": "BRI",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/12.png",
"form": null,
"coach_id": "9291",
"kit_colors": {
"away_main_color": "#ffffff",
"away_second_color": "#ffffff",
"away_number_color": "#306fbe",
"away_gk_main_color": "#fff200",
"away_gk_second_color": "#ffe900",
"away_gk_number_color": "#faf4f4"
}
}
},
"league": {
"id": 583,
"name": "Premier League",
"type": "Premier League 26/27",
"country_id": "3",
"country_name": "England",
"country_code": "en",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/en.png"
},
"scores": {
"home_score": "4",
"away_score": "3",
"ht_score": "3-1",
"ft_score": "4-3",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 8,
"away_position": 5
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 1,
"has_tvs": 1,
"has_standings": 1
},
"weather_report": {
"desc": "cloudy",
"temp": {
"celsius": 21.2,
"fahrenheit": 70.2
},
"wind": {
"kmph": 13.7,
"miles": 8.51,
"direction": "SW"
},
"humidity_percent": 56,
"pressure": 1009
},
"events": [
{
"team_id": 20,
"type": "corner",
"period": "1st half",
"player_id": null,
"player_name": null,
"related_player_id": null,
"related_player_name": null,
"minute": "4",
"extra_minute": null,
"timestamp": null,
"reason": null,
"injuried": null,
"own_goal": false,
"penalty": false,
"result": null,
"info": "1st Corner kick"
}
]
},
{
"id": 2589313,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "216028",
"round_name": "2",
"season_id": "21033",
"season_name": "26/27",
"stage_id": "3461",
"stage_name": "Regular Season - Premier League 26/27",
"group_id": "13583",
"group_name": "Premier League 26/27",
"aggregate_id": null,
"winner_team_id": "0",
"venue_id": "107",
"leg": null,
"week": "35",
"deleted": "0",
"related_id": null,
"info": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 13:00:00",
"date": "2026-08-30",
"time": "13:00:00",
"minute": 90,
"timestamp": 1788094800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 274,
"name": "Leeds United",
"short_code": "LEE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/274.png",
"form": null,
"coach_id": "43",
"kit_colors": {
"home_main_color": "#fdf9f9",
"home_second_color": "#21267e",
"home_number_color": "#17277f",
"home_gk_main_color": "#8ed797",
"home_gk_second_color": "#94d698",
"home_gk_number_color": "#0d3423"
}
},
"away": {
"id": 265,
"name": "Brentford FC",
"short_code": "BRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/265.png",
"form": null,
"coach_id": "12299",
"kit_colors": {
"away_main_color": "#282335",
"away_second_color": "#e5d9ca",
"away_number_color": "#fafaf9",
"away_gk_main_color": "#c597c6",
"away_gk_second_color": "#242841",
"away_gk_number_color": "#080808"
}
}
},
"league": {
"id": 583,
"name": "Premier League",
"type": "Premier League 26/27",
"country_id": "3",
"country_name": "England",
"country_code": "en",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/en.png"
},
"scores": {
"home_score": "1",
"away_score": "1",
"ht_score": "0-1",
"ft_score": "1-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 10,
"away_position": 6
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 1,
"has_tvs": 1,
"has_standings": 1
},
"weather_report": {
"desc": "cloudy",
"temp": {
"celsius": 20.7,
"fahrenheit": 69.3
},
"wind": {
"kmph": 11.9,
"miles": 7.39,
"direction": "SW"
},
"humidity_percent": 56,
"pressure": 1006
},
"events": [
{
"team_id": 265,
"type": "shot_off_target",
"period": "1st half",
"player_id": 20877,
"player_name": "Schade",
"related_player_id": null,
"related_player_name": null,
"minute": "1",
"extra_minute": null,
"timestamp": null,
"reason": null,
"injuried": null,
"own_goal": false,
"penalty": false,
"result": null,
"info": "1st Shot Off Target"
}
]
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 2,
"total": 2,
"msg": ""
}
}