Sync: add watched episodes method

Author: UweTrottmann

CHANGELOG.md

@@ -5,6 +5,7 @@
 * Address upcoming [Trakt pagination requirements](https://github.com/trakt/trakt-api/discussions/775) for watched methods:
   * Add paginated variants of `Sync.watchedMovies()`, `Sync.watchedShows()`, `Users.watchedMovies()` and 
     `Users.watchedShows()` with required `page` and `limit` parameters. The original methods are deprecated.
+* Add `Sync.watchedEpisodes()` 
 
 ## 6.18.0 - 2026-03-06
 

src/main/java/com/uwetrottmann/trakt5/entities/WatchedEpisode.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright © 2026 Uwe Trottmann <uwe@uwetrottmann.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.uwetrottmann.trakt5.entities;
+
+
+import org.threeten.bp.OffsetDateTime;
+
+public class WatchedEpisode {
+
+    public Integer plays;
+    /**
+     * Warning: Trakt is planning to only store and return minute-precision timestamps for watched_at. So seconds and
+     * nanoseconds will always be zero.
+     */
+    public OffsetDateTime last_watched_at;
+    public OffsetDateTime last_updated_at;
+
+    public Episode episode;
+
+}

src/main/java/com/uwetrottmann/trakt5/enums/ExtendedEpisodesWatched.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright © 2026 Uwe Trottmann <uwe@uwetrottmann.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.uwetrottmann.trakt5.enums;
+
+public class ExtendedEpisodesWatched implements TraktEnum {
+
+    /**
+     * Return details, like overview and rating.
+     */
+    public static final ExtendedEpisodesWatched FULL = new ExtendedEpisodesWatched("full");
+
+    private final String value;
+
+    private ExtendedEpisodesWatched(String value) {
+        this.value = value;
+    }
+
+    @Override
+    public String toString() {
+        return value;
+    }
+}

src/main/java/com/uwetrottmann/trakt5/services/Sync.java

@@ -29,9 +29,11 @@
 import com.uwetrottmann.trakt5.entities.SyncItems;
 import com.uwetrottmann.trakt5.entities.SyncResponse;
 import com.uwetrottmann.trakt5.entities.UserSlug;
+import com.uwetrottmann.trakt5.entities.WatchedEpisode;
 import com.uwetrottmann.trakt5.entities.WatchlistedEpisode;
 import com.uwetrottmann.trakt5.entities.WatchlistedSeason;
 import com.uwetrottmann.trakt5.enums.Extended;
+import com.uwetrottmann.trakt5.enums.ExtendedEpisodesWatched;
 import com.uwetrottmann.trakt5.enums.ExtendedMoviesWatched;
 import com.uwetrottmann.trakt5.enums.ExtendedShowsWatched;
 import com.uwetrottmann.trakt5.enums.HistoryType;
@@ -281,6 +283,21 @@ Call<List<BaseShow>> watchedShows(
             @Query(value = "extended", encoded = true) ExtendedShowsWatched extended
     );
 
+    /**
+     * <b>OAuth {@link TraktV2#accessToken(String) access token} required</b>
+     * <p>
+     * Returns all episodes a user has watched.
+     *
+     * @param page     Number of page of results to be returned.
+     * @param limit    Number of results to return per page.
+     */
+    @GET("sync/watched/episodes")
+    Call<List<WatchedEpisode>> watchedEpisodes(
+            @Query("page") int page,
+            @Query("limit") int limit,
+            @Query(value = "extended", encoded = true) ExtendedEpisodesWatched extended
+    );
+
     /**
      * <b>OAuth {@link TraktV2#accessToken(String) access token} required</b>
      * <p>

src/test/java/com/uwetrottmann/trakt5/services/SyncTest.java

@@ -43,9 +43,11 @@
 import com.uwetrottmann.trakt5.entities.SyncResponse;
 import com.uwetrottmann.trakt5.entities.SyncSeason;
 import com.uwetrottmann.trakt5.entities.SyncShow;
+import com.uwetrottmann.trakt5.entities.WatchedEpisode;
 import com.uwetrottmann.trakt5.entities.WatchlistedEpisode;
 import com.uwetrottmann.trakt5.entities.WatchlistedSeason;
 import com.uwetrottmann.trakt5.enums.Extended;
+import com.uwetrottmann.trakt5.enums.ExtendedEpisodesWatched;
 import com.uwetrottmann.trakt5.enums.ExtendedMoviesWatched;
 import com.uwetrottmann.trakt5.enums.ExtendedShowsWatched;
 import com.uwetrottmann.trakt5.enums.HistoryType;
@@ -362,6 +364,34 @@ public void test_watchedShows_extended() throws IOException {
         assertWatchedShowsFullNoSeasons(shows);
     }
 
+    @Test
+    public void test_watchedEpisodes() throws IOException {
+        Response<List<WatchedEpisode>> response = executeCallWithoutReadingBody(
+                getTrakt().sync().watchedEpisodes(PAGE_ONE, LIMIT_MAX, null));
+
+        // As of 2026-04-29, pagination is not supported, yet
+        // assertListPaginationHeaders(response);
+        assertThat(response.body())
+                .isNotEmpty()
+                .allSatisfy(episode -> {
+                    assertThat(episode.plays).isPositive();
+                    assertThat(episode.episode).isNotNull();
+                });
+    }
+
+    @Test
+    public void test_watchedEpisodes_extended() throws IOException {
+        List<WatchedEpisode> episodes = executeCall(
+                getTrakt().sync().watchedEpisodes(PAGE_ONE, LIMIT_MAX, ExtendedEpisodesWatched.FULL));
+
+        assertThat(episodes)
+                .isNotEmpty()
+                .allSatisfy(episode -> {
+                    assertThat(episode.episode).isNotNull();
+                    assertThat(episode.episode.rating).isNotNull();
+                });
+    }
+
     @Test
     public void test_addItemsToWatchedHistory() throws IOException {
         // movie