> ## 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 Recordings > Endpoints for managing Live TV recordings, timers, and series timers ## Get Recordings Retrieves a list of live TV recordings with optional filtering. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Recordings?limit=50" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Recordings` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Filter by channel ID Filter by user and attach user data 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 Filter by recording status: `New`, `InProgress`, `Completed`, `Cancelled`, `ConflictedOk`, `ConflictedNotOk`, `Error` Filter by recordings that are in progress, or not Filter by recordings belonging to a series timer 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) Additional fields of information to return in the output (comma-delimited) Include user data Filter for movies Filter for series Filter for kids content Filter for sports Filter for news Filter for is library item Return total record count ### Response Array of recording items Unique identifier for the recording Recording name Channel ID Recording start date and time Recording end date and time Recording status Associated series timer ID Total number of recordings Starting index of the returned results ### Status Codes * `200` - Live TV recordings returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Recording Retrieves detailed information about a specific live TV recording. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Recordings/{recordingId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Recordings/{recordingId}` ### Authentication Requires `LiveTvAccess` policy authorization. ### Path Parameters The recording ID ### Query Parameters Attach user data for this user ### Response Detailed recording information including metadata, images, and playback info ### Status Codes * `200` - Recording returned successfully * `404` - Recording not found * `401` - Unauthorized * `403` - Forbidden *** ## Delete Recording Deletes a live TV recording. ```bash cURL theme={null} curl -X DELETE "https://your-server/LiveTv/Recordings/{recordingId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint DELETE `/LiveTv/Recordings/{recordingId}` ### Authentication Requires `LiveTvManagement` policy authorization. ### Path Parameters The recording ID to delete ### Status Codes * `204` - Recording deleted successfully * `404` - Recording not found * `401` - Unauthorized * `403` - Forbidden (requires LiveTvManagement policy) *** ## Get Recording Folders Retrieves the list of recording folders. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Recordings/Folders" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Recordings/Folders` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Filter by user and attach user data ### Response Array of folder items containing recording folders Total number of folders ### Status Codes * `200` - Recording folders returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Live Recording Stream Gets a stream of an active live recording. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/LiveRecordings/{recordingId}/stream" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ --output recording.ts ``` ### Endpoint GET `/LiveTv/LiveRecordings/{recordingId}/stream` ### Path Parameters The recording ID ### Response Returns a video file stream of the active recording. ### Status Codes * `200` - Recording stream returned successfully * `404` - Recording not found or not active *** ## Get Timers Retrieves a list of live TV timers (scheduled recordings). ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Timers" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Timers` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Filter by channel ID Filter by timers belonging to a series timer Filter by timers that are active Filter by timers that are scheduled ### Response Array of timer information Timer ID Channel ID Program ID Timer start date and time Timer end date and time Timer status Total number of timers ### Status Codes * `200` - Timers returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Timer Retrieves a specific timer by ID. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Timers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Timers/{timerId}` ### Authentication Requires `LiveTvAccess` policy authorization. ### Path Parameters The timer ID ### Response Detailed timer information ### Status Codes * `200` - Timer returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Default Timer Retrieves default values for a new timer, optionally based on a program. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/Timers/Defaults?programId=PROGRAM_ID" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/Timers/Defaults` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Attach default values based on a program ### Response Default timer values ### Status Codes * `200` - Default values returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Create Timer Creates a new live TV timer (scheduled recording). ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/Timers" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ChannelId": "channel-id", "ProgramId": "program-id", "PrePaddingSeconds": 60, "PostPaddingSeconds": 300 }' ``` ### Endpoint POST `/LiveTv/Timers` ### Authentication Requires `LiveTvManagement` policy authorization. ### Request Body Channel ID to record from Program ID to record Seconds to start recording before the program starts Seconds to continue recording after the program ends ### Status Codes * `204` - Timer created successfully * `401` - Unauthorized * `403` - Forbidden (requires LiveTvManagement policy) * `400` - Bad request *** ## Update Timer Updates an existing live TV timer. ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/Timers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Id": "timer-id", "PrePaddingSeconds": 120, "PostPaddingSeconds": 600 }' ``` ### Endpoint POST `/LiveTv/Timers/{timerId}` ### Authentication Requires `LiveTvManagement` policy authorization. ### Path Parameters The timer ID to update ### Request Body TimerInfoDto object with updated values. ### Status Codes * `204` - Timer updated successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ## Cancel Timer Cancels a live TV timer. ```bash cURL theme={null} curl -X DELETE "https://your-server/LiveTv/Timers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint DELETE `/LiveTv/Timers/{timerId}` ### Authentication Requires `LiveTvManagement` policy authorization. ### Path Parameters The timer ID to cancel ### Status Codes * `204` - Timer cancelled successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Series Timers Retrieves a list of series timers (recurring recordings). ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/SeriesTimers" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/SeriesTimers` ### Authentication Requires `LiveTvAccess` policy authorization. ### Query Parameters Sort by SortName or Priority Sort order: `Ascending` or `Descending` ### Response Array of series timer information Total number of series timers ### Status Codes * `200` - Series timers returned successfully * `401` - Unauthorized * `403` - Forbidden *** ## Get Series Timer Retrieves a specific series timer by ID. ```bash cURL theme={null} curl -X GET "https://your-server/LiveTv/SeriesTimers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint GET `/LiveTv/SeriesTimers/{timerId}` ### Authentication Requires `LiveTvAccess` policy authorization. ### Path Parameters The series timer ID ### Response Detailed series timer information ### Status Codes * `200` - Series timer returned successfully * `404` - Series timer not found * `401` - Unauthorized * `403` - Forbidden *** ## Create Series Timer Creates a new series timer (recurring recording). ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/SeriesTimers" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ChannelId": "channel-id", "ProgramId": "program-id", "RecordAnyChannel": false, "RecordAnyTime": false, "RecordNewOnly": true }' ``` ### Endpoint POST `/LiveTv/SeriesTimers` ### Authentication Requires `LiveTvManagement` policy authorization. ### Request Body SeriesTimerInfoDto object with series timer configuration. ### Status Codes * `204` - Series timer created successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ## Update Series Timer Updates an existing series timer. ```bash cURL theme={null} curl -X POST "https://your-server/LiveTv/SeriesTimers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Id": "timer-id", "RecordNewOnly": true }' ``` ### Endpoint POST `/LiveTv/SeriesTimers/{timerId}` ### Authentication Requires `LiveTvManagement` policy authorization. ### Path Parameters The series timer ID to update ### Request Body SeriesTimerInfoDto object with updated values. ### Status Codes * `204` - Series timer updated successfully * `401` - Unauthorized * `403` - Forbidden * `400` - Bad request *** ## Cancel Series Timer Cancels a series timer. ```bash cURL theme={null} curl -X DELETE "https://your-server/LiveTv/SeriesTimers/{timerId}" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Endpoint DELETE `/LiveTv/SeriesTimers/{timerId}` ### Authentication Requires `LiveTvManagement` policy authorization. ### Path Parameters The series timer ID to cancel ### Status Codes * `204` - Series timer cancelled successfully * `401` - Unauthorized * `403` - Forbidden