SoccersAPIDocsv2.2
Docs/Reference/Fixtures/Fixtures by TV channel

GETFixtures by TV channel Standard, World Cup, Broadcast

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/?api_key=API_KEY&t=tv&tv_id=30

Parameters

NameRequiredDescriptionExample
tv_idyesTV channel ID.30
includenoComma-separated datasets to embed in the response, without spaces. Supported values: events, stats, broadcast, odds_prematch, odds_inplay. See the includes section.events,stats
bookmaker_idsnoComma-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
utcnoUTC 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
langnoLanguage 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

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": ""
  }
}