GETFixtures by TV channel
Matches scheduled on a TV channel over the next two weeks.
/v2.2/fixtures/ with t=tv
Try it in the interactive referenceAll Fixtures operations
Request
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=tv&tv_id=30- 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 |
|---|---|---|---|
tv_id | yes | TV channel ID. | 30 |
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": 2628127,
"status": "0",
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "219790",
"round_name": "4",
"season_id": "21208",
"season_name": "26/27",
"stage_id": "1",
"stage_name": "Regular Season",
"group_id": "13796",
"group_name": "Super Lig 26/27",
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "798",
"leg": null,
"week": "36",
"deleted": "0",
"related_id": null,
"info": null,
"attendance": null,
"time": {
"datetime": "2026-09-04 17:00:00",
"date": "2026-09-04",
"time": "17:00:00",
"minute": "",
"timestamp": 1788541200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 90,
"name": "Basaksehir FK",
"short_code": "BAS",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/90.png",
"form": null,
"coach_id": "7559",
"kit_colors": {
"home_main_color": "#f26522",
"home_second_color": "#14235e",
"home_number_color": "#122056",
"home_gk_main_color": "#d4f588",
"home_gk_second_color": "#d4f588",
"home_gk_number_color": "#000000"
}
},
"away": {
"id": 106,
"name": "Galatasaray",
"short_code": "GAL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/106.png",
"form": null,
"coach_id": "707",
"kit_colors": {
"away_main_color": "#ffffff",
"away_second_color": "#f27050",
"away_number_color": "#a02727",
"away_gk_main_color": "#0c5c33",
"away_gk_second_color": "#0d663c",
"away_gk_number_color": "#f8fcfb"
}
}
},
"league": {
"id": 3515,
"name": "Super Lig",
"type": "Super Lig 26/27",
"country_id": "118",
"country_name": "Turkey",
"country_code": "tr",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/tr.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": "-",
"ft_score": "-",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 9,
"away_position": 1
},
"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": 22.1,
"fahrenheit": 71.8
},
"wind": {
"kmph": 13.3,
"miles": 8.26,
"direction": "NE"
},
"humidity_percent": 76,
"pressure": 1016
}
}
],
"meta": {
"requests_left": 2950,
"user": "your_username",
"plan": "Soccer API 50",
"page": 1,
"pages": 1,
"count": 1,
"total": 1,
"msg": ""
}
}