GETFixtures by date
Matches on a date, optionally narrowed to a country, league, season, stage, group or round. Paginated, 100 items per page.
/v2.2/fixtures/ with t=schedule
Try it in the interactive referenceAll Fixtures operations
Request
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=schedule&d=2026-08-30&include=broadcast&utc=2- Paginated: 100 items per page; read
meta.pagesand request the next pages withpage. - Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
d | yes | Calendar date in YYYY-MM-DD format, interpreted in the utc offset when given. Any other format returns 400. | 2026-08-30 |
country_id | no | Country ID. | 4 |
league_id | no | League ID. | 594 |
season_id | no | Season ID. | 7194 |
stage_id | no | Stage ID. | 6 |
group_id | no | Group ID. | 308 |
round_id | no | Round ID. | 1994 |
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 |
page | no | Page number on paginated operations, starting at 1. The response reports meta.page and meta.pages; a page beyond the last returns an empty data. | 1 |
Example response
{
"data": [
{
"id": 2638183,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "220776",
"round_name": "2",
"season_id": "21256",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "2468",
"group_name": "Kategoria Superiore",
"aggregate_id": null,
"winner_team_id": 4475,
"venue_id": "626",
"leg": null,
"week": "35",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 21:00:00",
"date": "2026-08-30",
"time": "21:00:00",
"minute": 90,
"timestamp": 1788123600,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 4475,
"name": "KF Teuta",
"short_code": "TEU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/4475.png",
"form": null,
"coach_id": "13090",
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#ffffff",
"home_gk_second_color": "#ffffff",
"home_gk_number_color": "#0000ff"
}
},
"away": {
"id": 4707,
"name": "KF Tirana",
"short_code": "KFT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/4707.png",
"form": null,
"coach_id": "1864",
"kit_colors": {
"away_main_color": "#585858",
"away_second_color": "#585858",
"away_number_color": "#ffffff",
"away_gk_main_color": "#efc131",
"away_gk_second_color": "#333333",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 784,
"name": "Kategoria Superiore",
"type": "Kategoria Superiore",
"country_id": "8",
"country_name": "Albania",
"country_code": "al",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/al.png"
},
"scores": {
"home_score": "3",
"away_score": "1",
"ht_score": "0-1",
"ft_score": "3-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 6,
"away_position": 10
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": 0,
"has_tvs": 1,
"has_standings": 1
},
"weather_report": {
"desc": "mainly clear",
"temp": {
"celsius": 27.9,
"fahrenheit": 82.2
},
"wind": {
"kmph": 3.9,
"miles": 2.42,
"direction": "SE"
},
"humidity_percent": 81,
"pressure": 1013
},
"broadcast": [
{
"id": "13951",
"name": "DAZN France",
"type": "1",
"country": {
"id": "10",
"name": "Andorra",
"cc": "ad"
}
}
]
},
{
"id": 2673507,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "223647",
"round_name": "2",
"season_id": "21408",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "14150",
"group_name": "Girabola 26/27",
"aggregate_id": null,
"winner_team_id": 5844,
"venue_id": "1026",
"leg": null,
"week": "35",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 16:30:00",
"date": "2026-08-30",
"time": "16:30:00",
"minute": 90,
"timestamp": 1788107400,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 7620,
"name": "Petroleos Do Lobito",
"short_code": "APL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/7620.png",
"form": null,
"coach_id": null,
"kit_colors": {
"home_main_color": "#d8d8d8",
"home_second_color": "#d8d8d8",
"home_number_color": "#000000",
"home_gk_main_color": "#efc131",
"home_gk_second_color": "#333333",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 5844,
"name": "Atletico Petroleos de Luanda",
"short_code": "LUA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/5844.png",
"form": null,
"coach_id": null,
"kit_colors": {
"away_main_color": "#d8f510",
"away_second_color": "#000000",
"away_number_color": "#000000",
"away_gk_main_color": "#efc131",
"away_gk_second_color": "#333333",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 813,
"name": "Girabola",
"type": "Girabola 26/27",
"country_id": "11",
"country_name": "Angola",
"country_code": "ao",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/ao.png"
},
"scores": {
"home_score": "0",
"away_score": "2",
"ht_score": "-",
"ft_score": "0-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 14,
"away_position": 4
},
"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": 23.5,
"fahrenheit": 74.3
},
"wind": {
"kmph": 15.3,
"miles": 9.51,
"direction": "W"
},
"humidity_percent": 74,
"pressure": 1014
},
"broadcast": null
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 13,
"count": 100,
"total": 1241,
"msg": ""
}
}