Where a team is on
Where a team's matches are shown on TV, in every country or the ones you choose.
Paid plansLive data
GEThttps://api.tvguideapi.com/v1/teams/{id}/events
Try itRuns the real call with your key
200 OK
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| id | path | string | required | The team id. | india |
| country | query | list | optional | Country codes, ISO 3166-1 alpha-2, comma separated. | GB |
Request
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/teams/india/events"
$ch = curl_init("https://api.tvguideapi.com/v1/teams/india/events");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("TVG_KEY")],
]);
$answer = json_decode(curl_exec($ch), true);
const r = await fetch("https://api.tvguideapi.com/v1/teams/india/events", {
headers: { Authorization: `Bearer ${process.env.TVG_KEY}` },
});
const { data, meta } = await r.json();
import os, requests
r = requests.get(
"https://api.tvguideapi.com/v1/teams/india/events",
headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"},
)
data = r.json()["data"]
Sample response
{
"data": [
{
"id": "ev_d2bh99ey",
"sport": "football",
"league": {
"id": "chinese-professional-baseball-league",
"name": "Premier League"
},
"home": "Arsenal",
"away": "Chelsea",
"start": "2026-10-18T16:30:00Z",
"venue": {
"name": "Emirates Stadium",
"country": "GB"
},
"round": "Matchweek 8",
"broadcasts": [
{
"country": "GB",
"channel": "ch_3vd81kpz",
"start": "2026-10-18T16:30:00Z",
"kind": "live"
},
{
"country": "TH",
"channel": "ch_b62tq0we",
"start": "2026-10-18T16:30:00Z",
"kind": "live"
},
{
"country": "GB",
"channel": "ch_m0x4hs7r",
"start": "2026-10-18T22:00:00Z",
"kind": "repeat"
}
]
}
],
"meta": {
"count": 1,
"next": null,
"took_ms": 41
}
}