minimusdocs
Help center

Playlist editor

List a TV show's episodes

GET/editor/playlists/{pid}/series/{series_id}/episodes/

read Read: looks, changes nothing. Scopes

The TV show and its episodes by season and number, those in the recycle bin included (deleted_at set). Episodes from a provider login (server, username and password) are fetched from the provider the first time; error says why when it did not send them.

Path parameters

  • pidstring (uuid)required

    The playlist's id.

  • series_idintegerrequired

    The TV show's id (a row of the series list).

Response

200 OK

  • seriesobjectrequired

    The TV show.

    • idintegerrequired
    • kindstringrequired

      live, movie or series.

    • categoryintegerrequired

      Its category's id.

    • category_namestringrequired
    • providerintegerrequiredcan be null

      The provider it comes from; null for a row added by hand.

    • provider_keystringrequired

      Its id at the provider.

    • source_namestringrequired

      Its name at the provider.

    • namestringrequired
    • urlstringrequired

      The stream address players open.

    • logostringrequired
    • epg_idstringrequired

      The guide channel it shows the programmes of.

    • epg_shiftnumberrequired

      Hours added to its guide times.

    • numberintegerrequired

      Channel number; -1: none.

    • catchup_daysintegerrequired

      Days of catch-up players are told about.

    • tmdb_idintegerrequiredcan be null

      Its TMDB id (movies and TV shows).

    • ratingnumberrequiredcan be null
    • infoobjectrequired

      Plot, cast, genre, poster… of a movie or TV show.

    • positionintegerrequired

      Rows are listed by position in their category.

    • hiddenbooleanrequired

      Hidden from the playlist players get.

    • sync_namebooleanrequired

      Takes the provider's name again at each sync.

    • deleted_atstring (date-time)requiredcan be null

      When it went to the recycle bin; null when it is not there.

    • created_atstring (date-time)required
    • updated_atstring (date-time)required
    • episodesintegerrequiredcan be null

      A TV show's episodes; null for channels and movies, and while they are not fetched yet.

  • episodesobject[]required

    By season and number.

    • idintegerrequired
    • seasonintegerrequired

      -1: none.

    • numberintegerrequired

      -1: none.

    • namestringrequired
    • urlstringrequired

      The stream address players open.

    • infoobjectrequired
    • deleted_atstring (date-time)requiredcan be null

      When it went to the recycle bin; null when it is not there.

  • errorstringrequired

    Why the provider's episodes could not be fetched; '' when they were.

Errors

  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means