Function ItemsApiFp

Returns {
    getItems(
        userId?: string,
        maxOfficialRating?: string,
        hasThemeSong?: boolean,
        hasThemeVideo?: boolean,
        hasSubtitles?: boolean,
        hasSpecialFeature?: boolean,
        hasTrailer?: boolean,
        adjacentTo?: string,
        indexNumber?: number,
        parentIndexNumber?: number,
        hasParentalRating?: boolean,
        isHd?: boolean,
        is4K?: boolean,
        locationTypes?: LocationType[],
        excludeLocationTypes?: LocationType[],
        isMissing?: boolean,
        isUnaired?: boolean,
        minCommunityRating?: number,
        minCriticRating?: number,
        minPremiereDate?: string,
        minDateLastSaved?: string,
        minDateLastSavedForUser?: string,
        maxPremiereDate?: string,
        hasOverview?: boolean,
        hasImdbId?: boolean,
        hasTmdbId?: boolean,
        hasTvdbId?: boolean,
        isMovie?: boolean,
        isSeries?: boolean,
        isNews?: boolean,
        isKids?: boolean,
        isSports?: boolean,
        excludeItemIds?: string[],
        startIndex?: number,
        limit?: number,
        recursive?: boolean,
        searchTerm?: string,
        sortOrder?: SortOrder[],
        parentId?: string,
        fields?: ItemFields[],
        excludeItemTypes?: BaseItemKind[],
        includeItemTypes?: BaseItemKind[],
        filters?: ItemFilter[],
        isFavorite?: boolean,
        mediaTypes?: MediaType[],
        imageTypes?: ImageType[],
        sortBy?: ItemSortBy[],
        isPlayed?: boolean,
        genres?: string[],
        officialRatings?: string[],
        tags?: string[],
        years?: number[],
        enableUserData?: boolean,
        imageTypeLimit?: number,
        enableImageTypes?: ImageType[],
        person?: string,
        personIds?: string[],
        personTypes?: string[],
        studios?: string[],
        artists?: string[],
        excludeArtistIds?: string[],
        artistIds?: string[],
        albumArtistIds?: string[],
        contributingArtistIds?: string[],
        albums?: string[],
        albumIds?: string[],
        ids?: string[],
        videoTypes?: VideoType[],
        minOfficialRating?: string,
        isLocked?: boolean,
        isPlaceHolder?: boolean,
        hasOfficialRating?: boolean,
        collapseBoxSetItems?: boolean,
        minWidth?: number,
        minHeight?: number,
        maxWidth?: number,
        maxHeight?: number,
        is3D?: boolean,
        seriesStatus?: SeriesStatus[],
        nameStartsWithOrGreater?: string,
        nameStartsWith?: string,
        nameLessThan?: string,
        studioIds?: string[],
        genreIds?: string[],
        enableTotalRecordCount?: boolean,
        enableImages?: boolean,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >;
    getItemUserData(
        itemId: string,
        userId?: string,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >;
    getResumeItems(
        userId?: string,
        startIndex?: number,
        limit?: number,
        searchTerm?: string,
        parentId?: string,
        fields?: ItemFields[],
        mediaTypes?: MediaType[],
        enableUserData?: boolean,
        imageTypeLimit?: number,
        enableImageTypes?: ImageType[],
        excludeItemTypes?: BaseItemKind[],
        includeItemTypes?: BaseItemKind[],
        enableTotalRecordCount?: boolean,
        enableImages?: boolean,
        excludeActiveSessions?: boolean,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >;
    updateItemUserData(
        itemId: string,
        updateUserItemDataDto: UpdateUserItemDataDto,
        userId?: string,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >;
}

• getItems:function

  • getItems(
        userId?: string,
        maxOfficialRating?: string,
        hasThemeSong?: boolean,
        hasThemeVideo?: boolean,
        hasSubtitles?: boolean,
        hasSpecialFeature?: boolean,
        hasTrailer?: boolean,
        adjacentTo?: string,
        indexNumber?: number,
        parentIndexNumber?: number,
        hasParentalRating?: boolean,
        isHd?: boolean,
        is4K?: boolean,
        locationTypes?: LocationType[],
        excludeLocationTypes?: LocationType[],
        isMissing?: boolean,
        isUnaired?: boolean,
        minCommunityRating?: number,
        minCriticRating?: number,
        minPremiereDate?: string,
        minDateLastSaved?: string,
        minDateLastSavedForUser?: string,
        maxPremiereDate?: string,
        hasOverview?: boolean,
        hasImdbId?: boolean,
        hasTmdbId?: boolean,
        hasTvdbId?: boolean,
        isMovie?: boolean,
        isSeries?: boolean,
        isNews?: boolean,
        isKids?: boolean,
        isSports?: boolean,
        excludeItemIds?: string[],
        startIndex?: number,
        limit?: number,
        recursive?: boolean,
        searchTerm?: string,
        sortOrder?: SortOrder[],
        parentId?: string,
        fields?: ItemFields[],
        excludeItemTypes?: BaseItemKind[],
        includeItemTypes?: BaseItemKind[],
        filters?: ItemFilter[],
        isFavorite?: boolean,
        mediaTypes?: MediaType[],
        imageTypes?: ImageType[],
        sortBy?: ItemSortBy[],
        isPlayed?: boolean,
        genres?: string[],
        officialRatings?: string[],
        tags?: string[],
        years?: number[],
        enableUserData?: boolean,
        imageTypeLimit?: number,
        enableImageTypes?: ImageType[],
        person?: string,
        personIds?: string[],
        personTypes?: string[],
        studios?: string[],
        artists?: string[],
        excludeArtistIds?: string[],
        artistIds?: string[],
        albumArtistIds?: string[],
        contributingArtistIds?: string[],
        albums?: string[],
        albumIds?: string[],
        ids?: string[],
        videoTypes?: VideoType[],
        minOfficialRating?: string,
        isLocked?: boolean,
        isPlaceHolder?: boolean,
        hasOfficialRating?: boolean,
        collapseBoxSetItems?: boolean,
        minWidth?: number,
        minHeight?: number,
        maxWidth?: number,
        maxHeight?: number,
        is3D?: boolean,
        seriesStatus?: SeriesStatus[],
        nameStartsWithOrGreater?: string,
        nameStartsWith?: string,
        nameLessThan?: string,
        studioIds?: string[],
        genreIds?: string[],
        enableTotalRecordCount?: boolean,
        enableImages?: boolean,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >

  • Parameters

    • OptionaluserId: string

      The user id supplied as query parameter; this is required when not using an API key.
    • OptionalmaxOfficialRating: string

      Optional filter by maximum official rating (PG, PG-13, TV-MA, etc).
    • OptionalhasThemeSong: boolean

      Optional filter by items with theme songs.
    • OptionalhasThemeVideo: boolean

      Optional filter by items with theme videos.
    • OptionalhasSubtitles: boolean

      Optional filter by items with subtitles.
    • OptionalhasSpecialFeature: boolean

      Optional filter by items with special features.
    • OptionalhasTrailer: boolean

      Optional filter by items with trailers.
    • OptionaladjacentTo: string

      Optional. Return items that are siblings of a supplied item.
    • OptionalindexNumber: number

      Optional filter by index number.
    • OptionalparentIndexNumber: number

      Optional filter by parent index number.
    • OptionalhasParentalRating: boolean

      Optional filter by items that have or do not have a parental rating.
    • OptionalisHd: boolean

      Optional filter by items that are HD or not.
    • Optionalis4K: boolean

      Optional filter by items that are 4K or not.
    • OptionallocationTypes: LocationType[]

      Optional. If specified, results will be filtered based on LocationType. This allows multiple, comma delimited.
    • OptionalexcludeLocationTypes: LocationType[]

      Optional. If specified, results will be filtered based on the LocationType. This allows multiple, comma delimited.
    • OptionalisMissing: boolean

      Optional filter by items that are missing episodes or not.
    • OptionalisUnaired: boolean

      Optional filter by items that are unaired episodes or not.
    • OptionalminCommunityRating: number

      Optional filter by minimum community rating.
    • OptionalminCriticRating: number

      Optional filter by minimum critic rating.
    • OptionalminPremiereDate: string

      Optional. The minimum premiere date. Format = ISO.
    • OptionalminDateLastSaved: string

      Optional. The minimum last saved date. Format = ISO.
    • OptionalminDateLastSavedForUser: string

      Optional. The minimum last saved date for the current user. Format = ISO.
    • OptionalmaxPremiereDate: string

      Optional. The maximum premiere date. Format = ISO.
    • OptionalhasOverview: boolean

      Optional filter by items that have an overview or not.
    • OptionalhasImdbId: boolean

      Optional filter by items that have an IMDb id or not.
    • OptionalhasTmdbId: boolean

      Optional filter by items that have a TMDb id or not.
    • OptionalhasTvdbId: boolean

      Optional filter by items that have a TVDb id or not.
    • OptionalisMovie: boolean

      Optional filter for live tv movies.
    • OptionalisSeries: boolean

      Optional filter for live tv series.
    • OptionalisNews: boolean

      Optional filter for live tv news.
    • OptionalisKids: boolean

      Optional filter for live tv kids.
    • OptionalisSports: boolean

      Optional filter for live tv sports.
    • OptionalexcludeItemIds: string[]

      Optional. If specified, results will be filtered by excluding item ids. This allows multiple, comma delimited.
    • OptionalstartIndex: number

      Optional. The record index to start at. All items with a lower index will be dropped from the results.
    • Optionallimit: number

      Optional. The maximum number of records to return.
    • Optionalrecursive: boolean

      When searching within folders, this determines whether or not the search will be recursive. true/false.
    • OptionalsearchTerm: string

      Optional. Filter based on a search term.
    • OptionalsortOrder: SortOrder[]

      Sort Order - Ascending, Descending.
    • OptionalparentId: string

      Specify this to localize the search to a specific item or folder. Omit to use the root.
    • Optionalfields: ItemFields[]

      Optional. Specify additional fields of information to return in the output. This allows multiple, comma delimited. Options: Budget, Chapters, DateCreated, Genres, HomePageUrl, IndexOptions, MediaStreams, Overview, ParentId, Path, People, ProviderIds, PrimaryImageAspectRatio, Revenue, SortName, Studios, Taglines.
    • OptionalexcludeItemTypes: BaseItemKind[]

      Optional. If specified, results will be filtered based on item type. This allows multiple, comma delimited.
    • OptionalincludeItemTypes: BaseItemKind[]

      Optional. If specified, results will be filtered based on the item type. This allows multiple, comma delimited.
    • Optionalfilters: ItemFilter[]

      Optional. Specify additional filters to apply. This allows multiple, comma delimited. Options: IsFolder, IsNotFolder, IsUnplayed, IsPlayed, IsFavorite, IsResumable, Likes, Dislikes.
    • OptionalisFavorite: boolean

      Optional filter by items that are marked as favorite, or not.
    • OptionalmediaTypes: MediaType[]

      Optional filter by MediaType. Allows multiple, comma delimited.
    • OptionalimageTypes: ImageType[]

      Optional. If specified, results will be filtered based on those containing image types. This allows multiple, comma delimited.
    • OptionalsortBy: ItemSortBy[]

      Optional. Specify one or more sort orders, comma delimited. Options: Album, AlbumArtist, Artist, Budget, CommunityRating, CriticRating, DateCreated, DatePlayed, PlayCount, PremiereDate, ProductionYear, SortName, Random, Revenue, Runtime.
    • OptionalisPlayed: boolean

      Optional filter by items that are played, or not.
    • Optionalgenres: string[]

      Optional. If specified, results will be filtered based on genre. This allows multiple, pipe delimited.
    • OptionalofficialRatings: string[]

      Optional. If specified, results will be filtered based on OfficialRating. This allows multiple, pipe delimited.
    • Optionaltags: string[]

      Optional. If specified, results will be filtered based on tag. This allows multiple, pipe delimited.
    • Optionalyears: number[]

      Optional. If specified, results will be filtered based on production year. This allows multiple, comma delimited.
    • OptionalenableUserData: boolean

      Optional, include user data.
    • OptionalimageTypeLimit: number

      Optional, the max number of images to return, per image type.
    • OptionalenableImageTypes: ImageType[]

      Optional. The image types to include in the output.
    • Optionalperson: string

      Optional. If specified, results will be filtered to include only those containing the specified person.
    • OptionalpersonIds: string[]

      Optional. If specified, results will be filtered to include only those containing the specified person id.
    • OptionalpersonTypes: string[]

      Optional. If specified, along with Person, results will be filtered to include only those containing the specified person and PersonType. Allows multiple, comma-delimited.
    • Optionalstudios: string[]

      Optional. If specified, results will be filtered based on studio. This allows multiple, pipe delimited.
    • Optionalartists: string[]

      Optional. If specified, results will be filtered based on artists. This allows multiple, pipe delimited.
    • OptionalexcludeArtistIds: string[]

      Optional. If specified, results will be filtered based on artist id. This allows multiple, pipe delimited.
    • OptionalartistIds: string[]

      Optional. If specified, results will be filtered to include only those containing the specified artist id.
    • OptionalalbumArtistIds: string[]

      Optional. If specified, results will be filtered to include only those containing the specified album artist id.
    • OptionalcontributingArtistIds: string[]

      Optional. If specified, results will be filtered to include only those containing the specified contributing artist id.
    • Optionalalbums: string[]

      Optional. If specified, results will be filtered based on album. This allows multiple, pipe delimited.
    • OptionalalbumIds: string[]

      Optional. If specified, results will be filtered based on album id. This allows multiple, pipe delimited.
    • Optionalids: string[]

      Optional. If specific items are needed, specify a list of item id&#39;s to retrieve. This allows multiple, comma delimited.
    • OptionalvideoTypes: VideoType[]

      Optional filter by VideoType (videofile, dvd, bluray, iso). Allows multiple, comma delimited.
    • OptionalminOfficialRating: string

      Optional filter by minimum official rating (PG, PG-13, TV-MA, etc).
    • OptionalisLocked: boolean

      Optional filter by items that are locked.
    • OptionalisPlaceHolder: boolean

      Optional filter by items that are placeholders.
    • OptionalhasOfficialRating: boolean

      Optional filter by items that have official ratings.
    • OptionalcollapseBoxSetItems: boolean

      Whether or not to hide items behind their boxsets.
    • OptionalminWidth: number

      Optional. Filter by the minimum width of the item.
    • OptionalminHeight: number

      Optional. Filter by the minimum height of the item.
    • OptionalmaxWidth: number

      Optional. Filter by the maximum width of the item.
    • OptionalmaxHeight: number

      Optional. Filter by the maximum height of the item.
    • Optionalis3D: boolean

      Optional filter by items that are 3D, or not.
    • OptionalseriesStatus: SeriesStatus[]

      Optional filter by Series Status. Allows multiple, comma delimited.
    • OptionalnameStartsWithOrGreater: string

      Optional filter by items whose name is sorted equally or greater than a given input string.
    • OptionalnameStartsWith: string

      Optional filter by items whose name is sorted equally than a given input string.
    • OptionalnameLessThan: string

      Optional filter by items whose name is equally or lesser than a given input string.
    • OptionalstudioIds: string[]

      Optional. If specified, results will be filtered based on studio id. This allows multiple, pipe delimited.
    • OptionalgenreIds: string[]

      Optional. If specified, results will be filtered based on genre id. This allows multiple, pipe delimited.
    • OptionalenableTotalRecordCount: boolean

      Optional. Enable the total record count.
    • OptionalenableImages: boolean

      Optional, include image information in output.
    • Optionaloptions: RawAxiosRequestConfig

      Override http request option.

    Returns Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >

    Throws

• getItemUserData:function

  • getItemUserData(
        itemId: string,
        userId?: string,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >

  • Parameters

    • itemId: string

      The item id.
    • OptionaluserId: string

      The user id.
    • Optionaloptions: RawAxiosRequestConfig

      Override http request option.

    Returns Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >

    Throws

• getResumeItems:function

  • getResumeItems(
        userId?: string,
        startIndex?: number,
        limit?: number,
        searchTerm?: string,
        parentId?: string,
        fields?: ItemFields[],
        mediaTypes?: MediaType[],
        enableUserData?: boolean,
        imageTypeLimit?: number,
        enableImageTypes?: ImageType[],
        excludeItemTypes?: BaseItemKind[],
        includeItemTypes?: BaseItemKind[],
        enableTotalRecordCount?: boolean,
        enableImages?: boolean,
        excludeActiveSessions?: boolean,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >

  • Parameters

    • OptionaluserId: string

      The user id.
    • OptionalstartIndex: number

      The start index.
    • Optionallimit: number

      The item limit.
    • OptionalsearchTerm: string

      The search term.
    • OptionalparentId: string

      Specify this to localize the search to a specific item or folder. Omit to use the root.
    • Optionalfields: ItemFields[]

      Optional. Specify additional fields of information to return in the output. This allows multiple, comma delimited. Options: Budget, Chapters, DateCreated, Genres, HomePageUrl, IndexOptions, MediaStreams, Overview, ParentId, Path, People, ProviderIds, PrimaryImageAspectRatio, Revenue, SortName, Studios, Taglines.
    • OptionalmediaTypes: MediaType[]

      Optional. Filter by MediaType. Allows multiple, comma delimited.
    • OptionalenableUserData: boolean

      Optional. Include user data.
    • OptionalimageTypeLimit: number

      Optional. The max number of images to return, per image type.
    • OptionalenableImageTypes: ImageType[]

      Optional. The image types to include in the output.
    • OptionalexcludeItemTypes: BaseItemKind[]

      Optional. If specified, results will be filtered based on item type. This allows multiple, comma delimited.
    • OptionalincludeItemTypes: BaseItemKind[]

      Optional. If specified, results will be filtered based on the item type. This allows multiple, comma delimited.
    • OptionalenableTotalRecordCount: boolean

      Optional. Enable the total record count.
    • OptionalenableImages: boolean

      Optional. Include image information in output.
    • OptionalexcludeActiveSessions: boolean

      Optional. Whether to exclude the currently active sessions.
    • Optionaloptions: RawAxiosRequestConfig

      Override http request option.

    Returns Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<BaseItemDtoQueryResult>,
    >

    Throws

• updateItemUserData:function

  • updateItemUserData(
        itemId: string,
        updateUserItemDataDto: UpdateUserItemDataDto,
        userId?: string,
        options?: RawAxiosRequestConfig,
    ): Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >

  • Parameters

    • itemId: string

      The item id.
    • updateUserItemDataDto: UpdateUserItemDataDto

      New user data object.
    • OptionaluserId: string

      The user id.
    • Optionaloptions: RawAxiosRequestConfig

      Override http request option.

    Returns Promise<
        (
            axios?: AxiosInstance,
            basePath?: string,
        ) => AxiosPromise<UserItemDataDto>,
    >

    Throws