GET /scheduleGet the TV schedule for a specific country and date. Returns shows airing on TV networks for the given parameters. This is the endpoint for 'What's on TV tonight?' functionality. Results include show metadata and air times.
Complete list of episodes airing in a given country on a given date. Defaults to US and today.
- Default date is today if not specified - Use ISO 8601 date format (YYYY-MM-DD) - Country code is optional, defaults to US - Only shows with network airings are returned (web/Netflix excluded)
(string, query, optional)
ISO 3166-1 country code (e.g., US, GB, CA)
(string, query, optional)
ISO 8601 date (YYYY-MM-DD)
| Title | Type | URL | Action |
|---|---|---|---|
| Get TV schedule | openapi-spec |
https://api.tvmaze.com/schedule?country=US |
|
| Get schedule | doc_extracted |
https://api.tvmaze.com/schedule |
|
| Get schedule for country GB | doc_extracted |
https://api.tvmaze.com/schedule?country=GB |
|
| TV schedule | openapi-spec |
https://api.tvmaze.com/schedule?country=US&date=2024-01-15 |
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:44:36.128510 | 200 | 84ms | |
| 2026-03-23 10:18:47.635524 | 200 | 90ms | |
| 2026-03-23 09:37:51.588797 | 200 | 132ms | |
| 2026-03-23 09:03:33.126508 | 200 | 336ms |
| When | Old | New |
|---|---|---|
| 2026-03-23 09:37:51.588797 | fbdcd3a2d5f5 |
33d71b956222 |
| 2026-03-23 10:18:47.635524 | 33d71b956222 |
224061ac1afc |
| 2026-03-23 10:44:36.128510 | 224061ac1afc |
a4f16ff3d13d |