SoccersAPIDocsv2.2
Docs/Reference/Broadcast/Matches on TV by date

GETMatches on TV by date Free, Standard, World Cup, Broadcast

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/?api_key=API_KEY&t=schedule&d=2026-08-30&include=tvs&utc=2

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
tvs Free, Standard, World Cup, Broadcast

Full plan matrix.

Parameters

NameRequiredDescriptionExample
dyesCalendar date in YYYY-MM-DD format.2026-08-30
includenoDataset to embed in each scheduled match. See the includes section.tvs
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
pagenoPage 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_api_user",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 3,
    "count": 100,
    "total": 215,
    "msg": ""
  }
}