> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/jellyfin/jellyfin/llms.txt > Use this file to discover all available pages before exploring further. # Live TV Program Guide > Endpoints for retrieving Electronic Program Guide (EPG) data and program information ## Get Live TV Info Retrieves information about available live TV services. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Info" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Info` ### Authentication Requires `LiveTvAccess` policy authorization. ### Response Live TV service information Available live TV services Whether live TV is enabled Users with live TV access ### Status Codes * `200` - Available live TV services returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Programs (GET) Retrieves live TV program guide information (EPG data) using query parameters. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Programs?channelIds=CHANNEL_ID&limit=50" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Programs` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters The channels to return guide information for (comma-delimited GUIDs) Filter by user ID The minimum premiere start date Filter by programs that have completed airing, or not Filter by programs that are currently airing, or not The maximum premiere start date The minimum premiere end date The maximum premiere end date Filter for movies Filter for series Filter for news Filter for kids content Filter for sports The record index to start at. All items with a lower index will be dropped from the results The maximum number of records to return Sort orders (comma-delimited): Name, StartDate Sort order: Ascending or Descending (comma-delimited) The genres to return guide information for (pipe-delimited) The genre IDs to return guide information for (comma-delimited GUIDs) Include image information in output The max number of images to return, per image type The image types to include in the output (comma-delimited) Include user data Filter by series timer ID Filter by library series ID Additional fields of information to return in the output (comma-delimited) Retrieve total record count ### Response Array of program items Unique identifier for the program Program name Channel ID Program start date and time Program end date and time Program description Whether the program is a movie Whether the program is a series Whether the program is sports Whether the program is news Whether the program is for kids Total number of programs Starting index of the returned results ### Status Codes * `200` - Live TV EPG data returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Programs (POST) Retrieves live TV program guide information using a POST request with a JSON body. This is useful for complex queries that exceed URL length limits. ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/Programs" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "channelIds": ["channel-id-1", "channel-id-2"], "limit": 50, "isAiring": true, "enableImages": true }' ``` ### Endpoint POST `/LiveTv/Programs` ### Authentication Requires `LiveTvAccess` policy authorization. ### Request Body The channels to return guide information for (array of GUIDs) Filter by user ID The minimum premiere start date Filter by programs that have completed airing Filter by programs that are currently airing The maximum premiere start date The minimum premiere end date The maximum premiere end date Filter for movies Filter for series Filter for news Filter for kids content Filter for sports The record index to start at The maximum number of records to return Sort orders array Sort order array The genres to return guide information for The genre IDs to return guide information for Include image information in output The max number of images to return, per image type The image types to include in the output Include user data Filter by series timer ID Filter by library series ID Additional fields of information to return Retrieve total record count ### Response Same as GET /LiveTv/Programs response. ### Status Codes * `200` - Live TV EPG data returned successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ## Get Recommended Programs Retrieves recommended live TV programs based on user preferences. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Programs/Recommended?limit=20&isAiring=true" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Programs/Recommended` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Filter by user ID The record index to start at The maximum number of records to return Filter by programs that are currently airing Filter by programs that have completed airing Filter for series Filter for movies Filter for news Filter for kids content Filter for sports Include image information in output The max number of images to return, per image type The image types to include in the output (comma-delimited) The genres to return guide information for (comma-delimited GUIDs) Additional fields of information to return (comma-delimited) Include user data Retrieve total record count ### Response Array of recommended program items Total number of recommended programs Starting index of the returned results ### Status Codes * `200` - Recommended EPG data returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Program Retrieves detailed information about a specific program. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Programs/{programId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Programs/{programId}` ### Authentication Requires `LiveTvAccess` policy authorization. ### Path Parameters The program ID ### Query Parameters Attach user data for this user ### Response Detailed program information including metadata, schedule, and images ### Status Codes * `200` - Program returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Guide Info Retrieves information about the program guide configuration. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/GuideInfo" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/GuideInfo` ### Authentication Requires `LiveTvAccess` policy authorization. ### Response Guide configuration information Guide data start date Guide data end date ### Status Codes * `200` - Guide info returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Live Stream File Gets a live TV channel stream file. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/LiveStreamFiles/{streamId}/stream.ts" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ --output stream.ts ``` ### Endpoint GET `/LiveTv/LiveStreamFiles/{streamId}/stream.{container}` ### Path Parameters The stream ID Container type (e.g., ts, mp4) ### Response Returns a video file stream. ### Status Codes * `200` - Stream returned successfully * `404` - Stream not found *** ## Tuner and Provider Management ### Reset Tuner Resets a TV tuner. ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/Tuners/{tunerId}/Reset" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint POST `/LiveTv/Tuners/{tunerId}/Reset` #### Authentication Requires `LiveTvManagement` policy authorization. #### Path Parameters The tuner ID #### Status Codes * `204` - Tuner reset successfully * `401` - Unauthorized * `403` - Forbidden *** ### Add Tuner Host Adds a new tuner host to the system. ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/TunerHosts" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Type": "hdhomerun", "Url": "http://192.168.1.100" }' ``` #### Endpoint POST `/LiveTv/TunerHosts` #### Authentication Requires `LiveTvManagement` policy authorization. #### Request Body Tuner host type (e.g., hdhomerun, m3u) Tuner host URL #### Response Created tuner host information #### Status Codes * `200` - Tuner host created successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ### Delete Tuner Host Deletes a tuner host. ```bash cURL theme={null} curl -X DELETE "https://your-server/LiveTv/TunerHosts?id=TUNER_HOST_ID" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint DELETE `/LiveTv/TunerHosts` #### Authentication Requires `LiveTvManagement` policy authorization. #### Query Parameters Tuner host ID to delete #### Status Codes * `204` - Tuner host deleted successfully * `401` - Unauthorized * `403` - Forbidden *** ### Get Tuner Host Types Retrieves available tuner host types. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/TunerHosts/Types" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint GET `/LiveTv/TunerHosts/Types` #### Authentication Requires `LiveTvAccess` policy authorization. #### Response Array of tuner host type name-ID pairs. #### Status Codes * `200` - Tuner host types returned successfully * `401` - Unauthorized * `403` - Forbidden *** ### Discover Tuners Discovers available tuners on the network. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Tuners/Discover?newDevicesOnly=true" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint GET `/LiveTv/Tuners/Discover` #### Authentication Requires `LiveTvManagement` policy authorization. #### Query Parameters Only discover new tuners not already configured #### Response Async enumerable of discovered tuner host information. #### Status Codes * `200` - Tuners returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Listing Providers ### Get Default Listing Provider Retrieves default listings provider information. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/ListingProviders/Default" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint GET `/LiveTv/ListingProviders/Default` #### Authentication Requires `LiveTvAccess` policy authorization. #### Status Codes * `200` - Default listings provider info returned successfully *** ### Add Listing Provider Adds a new listings provider (e.g., Schedules Direct). ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/ListingProviders?pw=password" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Type": "SchedulesDirect", "Username": "your-username", "ListingsId": "lineup-id" }' ``` #### Endpoint POST `/LiveTv/ListingProviders` #### Authentication Requires `LiveTvManagement` policy authorization. #### Query Parameters Password (will be hashed) Validate listings Validate login credentials #### Request Body ListingsProviderInfo object. #### Response Created listings provider information #### Status Codes * `200` - Listing provider created successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ### Delete Listing Provider Deletes a listings provider. ```bash cURL theme={null} curl -X DELETE "https://your-server/LiveTv/ListingProviders?id=PROVIDER_ID" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint DELETE `/LiveTv/ListingProviders` #### Authentication Requires `LiveTvManagement` policy authorization. #### Query Parameters Listing provider ID to delete #### Status Codes * `204` - Listing provider deleted successfully * `401` - Unauthorized * `403` - Forbidden *** ### Get Lineups Retrieves available lineups for a listings provider. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/ListingProviders/Lineups?id=PROVIDER_ID" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint GET `/LiveTv/ListingProviders/Lineups` #### Authentication Requires `LiveTvAccess` policy authorization. #### Query Parameters Provider ID Provider type Location (e.g., zip code) Country code #### Response Array of available lineups (name-ID pairs). #### Status Codes * `200` - Available lineups returned successfully * `401` - Unauthorized * `403` - Forbidden *** ### Get Schedules Direct Countries Retrieves available countries for Schedules Direct. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/ListingProviders/SchedulesDirect/Countries" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` #### Endpoint GET `/LiveTv/ListingProviders/SchedulesDirect/Countries` #### Authentication Requires `LiveTvAccess` policy authorization. #### Response JSON file containing available countries. #### Status Codes * `200` - Countries returned successfully * `401` - Unauthorized * `403` - Forbidden