Request
GET /v2.2/fixtures/?api_key=API_KEY&t=schedule&d=2026-08-30&include=broadcast&utc=2
- Paginated: 100 items per page; read
meta.pages and request the next pages with page. - Operation plans: Free, Standard, World Cup. League coverage and request limits still apply. Plans outside this list receive
403 with meta.msg = Endpoint not available for your plan.. IDs or nested team/player information in an allowed response do not grant access to the corresponding standalone endpoints. - Example request plans: Free, Standard, World Cup. Optional datasets require their own plan permissions.
- Authenticate with
api_key=API_KEY in the URL, or Authorization: Bearer API_KEY as an alternative. Both use the same key, without a username. See authentication methods.
Includes and plan access
The operation and every requested dataset must be allowed. Combinations require all the listed permissions; the selector is not a list of entitlements. An include cannot unlock a restricted operation. A denied include can return 403 with Endpoint not available for your plan. or Include not available for your plan. in meta.msg.
| Include |
Plans on this operation |
events |
Free, Standard, World Cup |
stats |
Free, Standard, World Cup |
broadcast |
Free, Standard, World Cup |
odds_prematch |
Free, Standard, World Cup |
odds_inplay |
Free, Standard, World Cup |
Full plan matrix.
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 | Dataset or combination of datasets to embed in the response. Scalar lists canonical combinations, not account entitlements. Both the operation and every selected dataset must be allowed by your plan. The wire value is comma-separated without spaces. See the includes plan table. | events,stats |
bookmaker_ids | no | Comma-separated bookmaker IDs, without spaces, for include=odds_prematch, include=odds_inplay or both on livescores and fixture operations that accept these includes. Only the requested bookmakers are returned, in the supplied order within each market’s bookmakers array, where odds are available. For example, 9,2 selects bookmakers 9 then 2; 9,3,1 selects 9 then 3 then 1; 2 selects only bookmaker 2. | 9,2 |
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 catalogue names. Available codes: en, el, aa, it, de, es, ru, nl, pl, fr, pt, ka, vi, hi, tr, id, th, zh, zht, ro, ko and fa. Legacy aliases: gr maps to el, and ar maps to aa. Defaults to en; an unavailable code returns 400 Bad Request. Proper names can remain unchanged, and match, event, odds and statistics payloads are not translated. | en |
odds_format | no | Odds format for /v2.2/fixtures/: decimal or eu (default decimal format), fractional or uk, and american or us. | 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_api_user",
"plan": "Soccer API 50",
"page": 1,
"pages": 13,
"count": 100,
"total": 1241,
"msg": ""
}
}