GETMatches on TV by date
Matches broadcast on a date. Add include=tvs to embed the channel details in each match. Paginated, 100 items per page.
/v2.2/broadcast/ with t=schedule
Try it in the interactive referenceAll Broadcast operations
Request
GET /v2.2/broadcast/?user=USER&token=TOKEN&t=schedule&d=2026-08-30&include=tvs&utc=2- Paginated: 100 items per page; read
meta.pagesand request the next pages withpage. - Dataset theme: broadcast. Themed plans include only their own theme; Free and Standard plans include every theme for their leagues.
- Every request needs the
userandtokenquery parameters of the account.
Parameters
| Name | Required | Description | Example |
|---|---|---|---|
d | yes | Calendar date in YYYY-MM-DD format. | 2026-08-30 |
include | no | Comma-separated datasets to embed in the response, without spaces. Supported values: tvs. See the includes section. | tvs |
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 |
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": 2602155,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "217130",
"round_name": "6",
"season_id": "21080",
"season_name": "26/27",
"stage_id": "3",
"stage_name": "Apertura",
"group_id": "1",
"group_name": "Apertura",
"aggregate_id": null,
"winner_team_id": "19346",
"venue_id": "5741",
"leg": null,
"week": "35",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 00:00:00",
"date": "2026-08-30",
"time": "00:00:00",
"minute": 90,
"timestamp": 1788048000,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 19346,
"name": "Tlaxcala FC",
"short_code": "TLA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/19346.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": 6946,
"name": "Venados FC",
"short_code": "VDS",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/6946.png",
"form": null,
"coach_id": null,
"kit_colors": {
"away_main_color": "#ccff00",
"away_second_color": "#ccff00",
"away_number_color": "#ffffff",
"away_gk_main_color": "#660066",
"away_gk_second_color": "#000000",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 2798,
"name": "Liga de Ascenso, Apertura",
"type": "Apertura",
"country_id": "76",
"country_name": "Mexico",
"country_code": "mx",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/mx.png"
},
"scores": {
"home_score": "3",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "3-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 16,
"away_position": 6
},
"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": "thunderstorm",
"temp": {
"celsius": 17.9,
"fahrenheit": 64.2
},
"wind": {
"kmph": 9.6,
"miles": 5.97,
"direction": "N"
},
"humidity_percent": 77,
"pressure": 1016
},
"tvs": [
{
"id": 11700,
"name": "Disney+ Caribbean",
"type": "1",
"country": {
"id": 151,
"name": "Anguilla",
"cc": "ai"
}
}
]
},
{
"id": 2544691,
"status": 3,
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "211353",
"round_name": "1",
"season_id": "16106",
"season_name": "2026",
"stage_id": "2008",
"stage_name": "Regular Season - National Womens Soccer League 2026",
"group_id": "12857",
"group_name": "National Womens Soccer League 2026",
"aggregate_id": null,
"winner_team_id": "294035372",
"venue_id": "9122",
"leg": null,
"week": "35",
"deleted": "0",
"info": null,
"related_id": null,
"attendance": null,
"time": {
"datetime": "2026-08-30 00:30:00",
"date": "2026-08-30",
"time": "00:30:00",
"minute": 90,
"timestamp": 1788049800,
"timezone": "UTC+2"
},
"teams": {
"home": {
"id": 294035372,
"name": "Kansas City NWSL",
"short_code": "KC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/294035372.png",
"form": null,
"coach_id": "1616",
"kit_colors": {
"home_main_color": "#a71212",
"home_second_color": "#7bb4af",
"home_number_color": "#d7eee2",
"home_gk_main_color": "#cdcf64",
"home_gk_second_color": "#c193b1",
"home_gk_number_color": "#050505"
}
},
"away": {
"id": 7086,
"name": "North Carolina Courage (W)",
"short_code": "NCC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/7086.png",
"form": null,
"coach_id": "12877",
"kit_colors": {
"away_main_color": "#213973",
"away_second_color": "#8c1123",
"away_number_color": "#ffffff",
"away_gk_main_color": "#eed4fd",
"away_gk_second_color": "#04e600",
"away_gk_number_color": "#000000"
}
}
},
"league": {
"id": 3702,
"name": "National Womens Soccer League",
"type": "National Womens Soccer League 2026",
"country_id": "124",
"country_name": "USA",
"country_code": "us",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/us.png"
},
"scores": {
"home_score": "3",
"away_score": "2",
"ht_score": "3-1",
"ft_score": "3-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 7,
"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": "clear/sunny",
"temp": {
"celsius": 35.2,
"fahrenheit": 95.4
},
"wind": {
"kmph": 16.3,
"miles": 10.13,
"direction": "S"
},
"humidity_percent": 38,
"pressure": 1011
},
"tvs": [
{
"id": 5805,
"name": "Stan Sport",
"type": "Tv / Cable / Satellite",
"country": {
"id": 14,
"name": "Australia",
"cc": "au"
}
}
]
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 3,
"count": 100,
"total": 215,
"msg": ""
}
}