--- title: "Gets the live tv timers." method: GET path: "/LiveTv/Timers" tags: ["LiveTv"] --- # Gets the live tv timers. `GET /LiveTv/Timers` ## Query parameters - `channelId` string, nullable — Optional. Filter by channel id. - `seriesTimerId` string, nullable — Optional. Filter by timers belonging to a series timer. - `isActive` boolean, nullable — Optional. Filter by timers that are active. - `isScheduled` boolean, nullable — Optional. Filter by timers that are scheduled. ## Response `200` Success - TimerInfoDtoQueryResult - `Items` TimerInfoDto[], nullable — Gets or sets the items. - `Id` string, nullable — Id of the recording. - `Type` string, nullable - `ServerId` string, nullable — Gets or sets the server identifier. - `ExternalId` string, nullable — Gets or sets the external identifier. - `ChannelId` string, uuid — ChannelId of the recording. - `ExternalChannelId` string, nullable — Gets or sets the external channel identifier. - `ChannelName` string, nullable — ChannelName of the recording. - `ChannelPrimaryImageTag` string, nullable - `ProgramId` string, nullable — Gets or sets the program identifier. - `ExternalProgramId` string, nullable — Gets or sets the external program identifier. - `Name` string, nullable — Name of the recording. - `Overview` string, nullable — Description of the recording. - `StartDate` string, date-time — The start date of the recording, in UTC. - `EndDate` string, date-time — The end date of the recording, in UTC. - `ServiceName` string, nullable — Gets or sets the name of the service. - `Priority` integer — Gets or sets the priority. - `PrePaddingSeconds` integer — Gets or sets the pre padding seconds. - `PostPaddingSeconds` integer — Gets or sets the post padding seconds. - `IsPrePaddingRequired` boolean — Gets or sets a value indicating whether this instance is pre padding required. - `ParentBackdropItemId` string, nullable — If the item does not have any backdrops, this will hold the Id of the Parent that has one. - `ParentBackdropImageTags` string[], nullable — Gets or sets the parent backdrop image tags. - `IsPostPaddingRequired` boolean — Gets or sets a value indicating whether this instance is post padding required. - `KeepUntil` 'UntilDeleted' | 'UntilSpaceNeeded' | 'UntilWatched' | 'UntilDate' - `Status` 'New' | 'InProgress' | 'Completed' | 'Cancelled' | 'ConflictedOk' | 'ConflictedNotOk' | 'Error' - `SeriesTimerId` string, nullable — Gets or sets the series timer identifier. - `ExternalSeriesTimerId` string, nullable — Gets or sets the external series timer identifier. - `RunTimeTicks` integer, nullable — Gets or sets the run time ticks. - `ProgramInfo` BaseItemDto — This is strictly used as a data transfer object from the api layer. This holds information about a BaseItem in a format that is convenient for the client. - `Name` string, nullable — Gets or sets the name. - `OriginalTitle` string, nullable - `ServerId` string, nullable — Gets or sets the server identifier. - `Id` string, uuid — Gets or sets the id. - `Etag` string, nullable — Gets or sets the etag. - `SourceType` string, nullable — Gets or sets the type of the source. - `PlaylistItemId` string, nullable — Gets or sets the playlist item identifier. - `DateCreated` string, date-time, nullable — Gets or sets the date created. - `DateLastMediaAdded` string, date-time, nullable - `ExtraType` string, nullable - `AirsBeforeSeasonNumber` integer, nullable - `AirsAfterSeasonNumber` integer, nullable - `AirsBeforeEpisodeNumber` integer, nullable - `CanDelete` boolean, nullable - `CanDownload` boolean, nullable - `HasSubtitles` boolean, nullable - `PreferredMetadataLanguage` string, nullable - `PreferredMetadataCountryCode` string, nullable - `SupportsSync` boolean, nullable — Gets or sets a value indicating whether [supports synchronize]. - `Container` string, nullable - `SortName` string, nullable — Gets or sets the name of the sort. - `ForcedSortName` string, nullable - `Video3DFormat` 'HalfSideBySide' | 'FullSideBySide' | 'FullTopAndBottom' | 'HalfTopAndBottom' | 'MVC' - `PremiereDate` string, date-time, nullable — Gets or sets the premiere date. - `ExternalUrls` ExternalUrl[], nullable — Gets or sets the external urls. - `Name` string, nullable — Gets or sets the name. - `Url` string, nullable — Gets or sets the type of the item. - `MediaSources` MediaSourceInfo[], nullable — Gets or sets the media versions. - `Protocol` 'File' | 'Http' | 'Rtmp' | 'Rtsp' | 'Udp' | 'Rtp' | 'Ftp' - `Id` string, nullable - `Path` string, nullable - `EncoderPath` string, nullable - `EncoderProtocol` 'File' | 'Http' | 'Rtmp' | 'Rtsp' | 'Udp' | 'Rtp' | 'Ftp' - `Type` 'Default' | 'Grouping' | 'Placeholder' - `Container` string, nullable - `Size` integer, nullable - `Name` string, nullable - `IsRemote` boolean — Differentiate internet url vs local network. - `ETag` string, nullable - `RunTimeTicks` integer, nullable - `ReadAtNativeFramerate` boolean - `IgnoreDts` boolean - `IgnoreIndex` boolean - `GenPtsInput` boolean - `SupportsTranscoding` boolean - `SupportsDirectStream` boolean - `SupportsDirectPlay` boolean - `IsInfiniteStream` boolean - `RequiresOpening` boolean - `OpenToken` string, nullable - `RequiresClosing` boolean - `LiveStreamId` string, nullable - `BufferMs` integer, nullable - `RequiresLooping` boolean - `SupportsProbing` boolean - `VideoType` 'VideoFile' | 'Iso' | 'Dvd' | 'BluRay' — Enum VideoType. - `IsoType` 'Dvd' | 'BluRay' — Enum IsoType. - `Video3DFormat` 'HalfSideBySide' | 'FullSideBySide' | 'FullTopAndBottom' | 'HalfTopAndBottom' | 'MVC' - `MediaStreams` MediaStream[], nullable - `Codec` string, nullable — Gets or sets the codec. - `CodecTag` string, nullable — Gets or sets the codec tag. - `Language` string, nullable — Gets or sets the language. - `ColorRange` string, nullable — Gets or sets the color range. - `ColorSpace` string, nullable — Gets or sets the color space. - `ColorTransfer` string, nullable — Gets or sets the color transfer. - `ColorPrimaries` string, nullable — Gets or sets the color primaries. - `Comment` string, nullable — Gets or sets the comment. - `TimeBase` string, nullable — Gets or sets the time base. - `CodecTimeBase` string, nullable — Gets or sets the codec time base. - `Title` string, nullable — Gets or sets the title. - `VideoRange` string, nullable — Gets or sets the video range. - `localizedUndefined` string, nullable - `localizedDefault` string, nullable - `localizedForced` string, nullable - `DisplayTitle` string, nullable - `NalLengthSize` string, nullable - `IsInterlaced` boolean — Gets or sets a value indicating whether this instance is interlaced. - `IsAVC` boolean, nullable - `ChannelLayout` string, nullable — Gets or sets the channel layout. - `BitRate` integer, nullable — Gets or sets the bit rate. - `BitDepth` integer, nullable — Gets or sets the bit depth. - `RefFrames` integer, nullable — Gets or sets the reference frames. - `PacketLength` integer, nullable — Gets or sets the length of the packet. - `Channels` integer, nullable — Gets or sets the channels. - `SampleRate` integer, nullable — Gets or sets the sample rate. - `IsDefault` boolean — Gets or sets a value indicating whether this instance is default. - `IsForced` boolean — Gets or sets a value indicating whether this instance is forced. - `Height` integer, nullable — Gets or sets the height. - `Width` integer, nullable — Gets or sets the width. - `AverageFrameRate` number, float, nullable — Gets or sets the average frame rate. - `RealFrameRate` number, float, nullable — Gets or sets the real frame rate. - `Profile` string, nullable — Gets or sets the profile. - `Type` 'Audio' | 'Video' | 'Subtitle' | 'EmbeddedImage' — Enum MediaStreamType. - `AspectRatio` string, nullable — Gets or sets the aspect ratio. - `Index` integer — Gets or sets the index. - `Score` integer, nullable — Gets or sets the score. - `IsExternal` boolean — Gets or sets a value indicating whether this instance is external. - `DeliveryMethod` 'Encode' | 'Embed' | 'External' | 'Hls' - `DeliveryUrl` string, nullable — Gets or sets the delivery URL. - `IsExternalUrl` boolean, nullable — Gets or sets a value indicating whether this instance is external URL. - `IsTextSubtitleStream` boolean - `SupportsExternalStream` boolean — Gets or sets a value indicating whether [supports external stream]. - `Path` string, nullable — Gets or sets the filename. - `PixelFormat` string, nullable — Gets or sets the pixel format. - `Level` number, double, nullable — Gets or sets the level. - `IsAnamorphic` boolean, nullable — Gets a value indicating whether this instance is anamorphic. - `MediaAttachments` MediaAttachment[], nullable - `Codec` string, nullable — Gets or sets the codec. - `CodecTag` string, nullable — Gets or sets the codec tag. - `Comment` string, nullable — Gets or sets the comment. - `Index` integer — Gets or sets the index. - `FileName` string, nullable — Gets or sets the filename. - `MimeType` string, nullable — Gets or sets the MIME type. - `DeliveryUrl` string, nullable — Gets or sets the delivery URL. - `Formats` string[], nullable - `Bitrate` integer, nullable - `Timestamp` 'None' | 'Zero' | 'Valid' - `RequiredHttpHeaders` object, nullable - `TranscodingUrl` string, nullable - `TranscodingSubProtocol` string, nullable - `TranscodingContainer` string, nullable - `AnalyzeDurationMs` integer, nullable - `DefaultAudioStreamIndex` integer, nullable - `DefaultSubtitleStreamIndex` integer, nullable - `CriticRating` number, float, nullable — Gets or sets the critic rating. - `ProductionLocations` string[], nullable - `Path` string, nullable — Gets or sets the path. - `EnableMediaSourceDisplay` boolean, nullable - `OfficialRating` string, nullable — Gets or sets the official rating. - `CustomRating` string, nullable — Gets or sets the custom rating. - `ChannelId` string, uuid, nullable — Gets or sets the channel identifier. - `ChannelName` string, nullable - `Overview` string, nullable — Gets or sets the overview. - `Taglines` string[], nullable — Gets or sets the taglines. - `Genres` string[], nullable — Gets or sets the genres. - `CommunityRating` number, float, nullable — Gets or sets the community rating. - `CumulativeRunTimeTicks` integer, nullable — Gets or sets the cumulative run time ticks. - `RunTimeTicks` integer, nullable — Gets or sets the run time ticks. - `PlayAccess` 'Full' | 'None' - `AspectRatio` string, nullable — Gets or sets the aspect ratio. - `ProductionYear` integer, nullable — Gets or sets the production year. - `IsPlaceHolder` boolean, nullable — Gets or sets a value indicating whether this instance is place holder. - `Number` string, nullable — Gets or sets the number. - `ChannelNumber` string, nullable - `IndexNumber` integer, nullable — Gets or sets the index number. - `IndexNumberEnd` integer, nullable — Gets or sets the index number end. - `ParentIndexNumber` integer, nullable — Gets or sets the parent index number. - `RemoteTrailers` MediaUrl[], nullable — Gets or sets the trailer urls. - `Url` string, nullable - `Name` string, nullable - `ProviderIds` object, nullable — Gets or sets the provider ids. - `IsHD` boolean, nullable — Gets or sets a value indicating whether this instance is HD. - `IsFolder` boolean, nullable — Gets or sets a value indicating whether this instance is folder. - `ParentId` string, uuid, nullable — Gets or sets the parent id. - `Type` string, nullable — Gets or sets the type. - `People` BaseItemPerson[], nullable — Gets or sets the people. - `Name` string, nullable — Gets or sets the name. - `Id` string, nullable — Gets or sets the identifier. - `Role` string, nullable — Gets or sets the role. - `Type` string, nullable — Gets or sets the type. - `PrimaryImageTag` string, nullable — Gets or sets the primary image tag. - `ImageBlurHashes` object, nullable — Gets or sets the primary image blurhash. - `Primary` object - `Art` object - `Backdrop` object - `Banner` object - `Logo` object - `Thumb` object - `Disc` object - `Box` object - `Screenshot` object - `Menu` object - `Chapter` object - `BoxRear` object - `Profile` object - `Studios` NameGuidPair[], nullable — Gets or sets the studios. - `Name` string, nullable - `Id` string, uuid - `GenreItems` NameGuidPair[], nullable - `Name` string, nullable - `Id` string, uuid - `ParentLogoItemId` string, nullable — If the item does not have a logo, this will hold the Id of the Parent that has one. - `ParentBackdropItemId` string, nullable — If the item does not have any backdrops, this will hold the Id of the Parent that has one. - `ParentBackdropImageTags` string[], nullable — Gets or sets the parent backdrop image tags. - `LocalTrailerCount` integer, nullable — Gets or sets the local trailer count. - `UserData` UserItemDataDto — Class UserItemDataDto. - `Rating` number, double, nullable — Gets or sets the rating. - `PlayedPercentage` number, double, nullable — Gets or sets the played percentage. - `UnplayedItemCount` integer, nullable — Gets or sets the unplayed item count. - `PlaybackPositionTicks` integer — Gets or sets the playback position ticks. - `PlayCount` integer — Gets or sets the play count. - `IsFavorite` boolean — Gets or sets a value indicating whether this instance is favorite. - `Likes` boolean, nullable — Gets or sets a value indicating whether this MediaBrowser.Model.Dto.UserItemDataDto is likes. - `LastPlayedDate` string, date-time, nullable — Gets or sets the last played date. - `Played` boolean — Gets or sets a value indicating whether this MediaBrowser.Model.Dto.UserItemDataDto is played. - `Key` string, nullable — Gets or sets the key. - `ItemId` string, nullable — Gets or sets the item identifier. - `RecursiveItemCount` integer, nullable — Gets or sets the recursive item count. - `ChildCount` integer, nullable — Gets or sets the child count. - `SeriesName` string, nullable — Gets or sets the name of the series. - `SeriesId` string, uuid, nullable — Gets or sets the series id. - `SeasonId` string, uuid, nullable — Gets or sets the season identifier. - `SpecialFeatureCount` integer, nullable — Gets or sets the special feature count. - `DisplayPreferencesId` string, nullable — Gets or sets the display preferences id. - `Status` string, nullable — Gets or sets the status. - `AirTime` string, nullable — Gets or sets the air time. - `AirDays` DayOfWeek[], nullable — Gets or sets the air days. - `Tags` string[], nullable — Gets or sets the tags. - `PrimaryImageAspectRatio` number, double, nullable — Gets or sets the primary image aspect ratio, after image enhancements. - `Artists` string[], nullable — Gets or sets the artists. - `ArtistItems` NameGuidPair[], nullable — Gets or sets the artist items. - `Name` string, nullable - `Id` string, uuid - `Album` string, nullable — Gets or sets the album. - `CollectionType` string, nullable — Gets or sets the type of the collection. - `DisplayOrder` string, nullable — Gets or sets the display order. - `AlbumId` string, uuid, nullable — Gets or sets the album id. - `AlbumPrimaryImageTag` string, nullable — Gets or sets the album image tag. - `SeriesPrimaryImageTag` string, nullable — Gets or sets the series primary image tag. - `AlbumArtist` string, nullable — Gets or sets the album artist. - `AlbumArtists` NameGuidPair[], nullable — Gets or sets the album artists. - `Name` string, nullable - `Id` string, uuid - `SeasonName` string, nullable — Gets or sets the name of the season. - `MediaStreams` MediaStream[], nullable — Gets or sets the media streams. - `Codec` string, nullable — Gets or sets the codec. - `CodecTag` string, nullable — Gets or sets the codec tag. - `Language` string, nullable — Gets or sets the language. - `ColorRange` string, nullable — Gets or sets the color range. - `ColorSpace` string, nullable — Gets or sets the color space. - `ColorTransfer` string, nullable — Gets or sets the color transfer. - `ColorPrimaries` string, nullable — Gets or sets the color primaries. - `Comment` string, nullable — Gets or sets the comment. - `TimeBase` string, nullable — Gets or sets the time base. - `CodecTimeBase` string, nullable — Gets or sets the codec time base. - `Title` string, nullable — Gets or sets the title. - `VideoRange` string, nullable — Gets or sets the video range. - `localizedUndefined` string, nullable - `localizedDefault` string, nullable - `localizedForced` string, nullable - `DisplayTitle` string, nullable - `NalLengthSize` string, nullable - `IsInterlaced` boolean — Gets or sets a value indicating whether this instance is interlaced. - `IsAVC` boolean, nullable - `ChannelLayout` string, nullable — Gets or sets the channel layout. - `BitRate` integer, nullable — Gets or sets the bit rate. - `BitDepth` integer, nullable — Gets or sets the bit depth. - `RefFrames` integer, nullable — Gets or sets the reference frames. - `PacketLength` integer, nullable — Gets or sets the length of the packet. - `Channels` integer, nullable — Gets or sets the channels. - `SampleRate` integer, nullable — Gets or sets the sample rate. - `IsDefault` boolean — Gets or sets a value indicating whether this instance is default. - `IsForced` boolean — Gets or sets a value indicating whether this instance is forced. - `Height` integer, nullable — Gets or sets the height. - `Width` integer, nullable — Gets or sets the width. - `AverageFrameRate` number, float, nullable — Gets or sets the average frame rate. - `RealFrameRate` number, float, nullable — Gets or sets the real frame rate. - `Profile` string, nullable — Gets or sets the profile. - `Type` 'Audio' | 'Video' | 'Subtitle' | 'EmbeddedImage' — Enum MediaStreamType. - `AspectRatio` string, nullable — Gets or sets the aspect ratio. - `Index` integer — Gets or sets the index. - `Score` integer, nullable — Gets or sets the score. - `IsExternal` boolean — Gets or sets a value indicating whether this instance is external. - `DeliveryMethod` 'Encode' | 'Embed' | 'External' | 'Hls' - `DeliveryUrl` string, nullable — Gets or sets the delivery URL. - `IsExternalUrl` boolean, nullable — Gets or sets a value indicating whether this instance is external URL. - `IsTextSubtitleStream` boolean - `SupportsExternalStream` boolean — Gets or sets a value indicating whether [supports external stream]. - `Path` string, nullable — Gets or sets the filename. - `PixelFormat` string, nullable — Gets or sets the pixel format. - `Level` number, double, nullable — Gets or sets the level. - `IsAnamorphic` boolean, nullable — Gets a value indicating whether this instance is anamorphic. - `VideoType` 'VideoFile' | 'Iso' | 'Dvd' | 'BluRay' — Enum VideoType. - `PartCount` integer, nullable — Gets or sets the part count. - `MediaSourceCount` integer, nullable - `ImageTags` object, nullable — Gets or sets the image tags. - `BackdropImageTags` string[], nullable — Gets or sets the backdrop image tags. - `ScreenshotImageTags` string[], nullable — Gets or sets the screenshot image tags. - `ParentLogoImageTag` string, nullable — Gets or sets the parent logo image tag. - `ParentArtItemId` string, nullable — If the item does not have a art, this will hold the Id of the Parent that has one. - `ParentArtImageTag` string, nullable — Gets or sets the parent art image tag. - `SeriesThumbImageTag` string, nullable — Gets or sets the series thumb image tag. - `ImageBlurHashes` object, nullable — Gets or sets the blurhashes for the image tags. Maps image type to dictionary mapping image tag to blurhash value. - `Primary` object - `Art` object - `Backdrop` object - `Banner` object - `Logo` object - `Thumb` object - `Disc` object - `Box` object - `Screenshot` object - `Menu` object - `Chapter` object - `BoxRear` object - `Profile` object - `SeriesStudio` string, nullable — Gets or sets the series studio. - `ParentThumbItemId` string, nullable — Gets or sets the parent thumb item id. - `ParentThumbImageTag` string, nullable — Gets or sets the parent thumb image tag. - `ParentPrimaryImageItemId` string, nullable — Gets or sets the parent primary image item identifier. - `ParentPrimaryImageTag` string, nullable — Gets or sets the parent primary image tag. - `Chapters` ChapterInfo[], nullable — Gets or sets the chapters. - `StartPositionTicks` integer — Gets or sets the start position ticks. - `Name` string, nullable — Gets or sets the name. - `ImagePath` string, nullable — Gets or sets the image path. - `ImageDateModified` string, date-time - `ImageTag` string, nullable - `LocationType` 'FileSystem' | 'Remote' | 'Virtual' | 'Offline' — Enum LocationType. - `IsoType` 'Dvd' | 'BluRay' — Enum IsoType. - `MediaType` string, nullable — Gets or sets the type of the media. - `EndDate` string, date-time, nullable — Gets or sets the end date. - `LockedFields` MetadataField[], nullable — Gets or sets the locked fields. - `TrailerCount` integer, nullable — Gets or sets the trailer count. - `MovieCount` integer, nullable — Gets or sets the movie count. - `SeriesCount` integer, nullable — Gets or sets the series count. - `ProgramCount` integer, nullable - `EpisodeCount` integer, nullable — Gets or sets the episode count. - `SongCount` integer, nullable — Gets or sets the song count. - `AlbumCount` integer, nullable — Gets or sets the album count. - `ArtistCount` integer, nullable - `MusicVideoCount` integer, nullable — Gets or sets the music video count. - `LockData` boolean, nullable — Gets or sets a value indicating whether [enable internet providers]. - `Width` integer, nullable - `Height` integer, nullable - `CameraMake` string, nullable - `CameraModel` string, nullable - `Software` string, nullable - `ExposureTime` number, double, nullable - `FocalLength` number, double, nullable - `ImageOrientation` 'TopLeft' | 'TopRight' | 'BottomRight' | 'BottomLeft' | 'LeftTop' | 'RightTop' | 'RightBottom' | 'LeftBottom' - `Aperture` number, double, nullable - `ShutterSpeed` number, double, nullable - `Latitude` number, double, nullable - `Longitude` number, double, nullable - `Altitude` number, double, nullable - `IsoSpeedRating` integer, nullable - `SeriesTimerId` string, nullable — Gets or sets the series timer identifier. - `ProgramId` string, nullable — Gets or sets the program identifier. - `ChannelPrimaryImageTag` string, nullable — Gets or sets the channel primary image tag. - `StartDate` string, date-time, nullable — The start date of the recording, in UTC. - `CompletionPercentage` number, double, nullable — Gets or sets the completion percentage. - `IsRepeat` boolean, nullable — Gets or sets a value indicating whether this instance is repeat. - `EpisodeTitle` string, nullable — Gets or sets the episode title. - `ChannelType` 'TV' | 'Radio' — Enum ChannelType. - `Audio` 'Mono' | 'Stereo' | 'Dolby' | 'DolbyDigital' | 'Thx' | 'Atmos' - `IsMovie` boolean, nullable — Gets or sets a value indicating whether this instance is movie. - `IsSports` boolean, nullable — Gets or sets a value indicating whether this instance is sports. - `IsSeries` boolean, nullable — Gets or sets a value indicating whether this instance is series. - `IsLive` boolean, nullable — Gets or sets a value indicating whether this instance is live. - `IsNews` boolean, nullable — Gets or sets a value indicating whether this instance is news. - `IsKids` boolean, nullable — Gets or sets a value indicating whether this instance is kids. - `IsPremiere` boolean, nullable — Gets or sets a value indicating whether this instance is premiere. - `TimerId` string, nullable — Gets or sets the timer identifier. - `CurrentProgram` BaseItemDto — recursive - `TotalRecordCount` integer — The total number of records available. - `StartIndex` integer — The index of the first record in Items. ## Other responses - `401` — Unauthorized - `403` — Forbidden --- [API](https://skmtc.net/jellyfin/apis/jellyfin-api.md) · [All operations](https://skmtc.net/jellyfin/apis/jellyfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jellyfin/jellyfin-api/versions/eb6f75af7066/schema)