Skip to main content

Add since filter to watched history endpoints

Add since filter to watched history endpoints

Summary

Add an optional since query parameter to the existing watched history endpoints.

The parameter should filter results by their watch timestamp. The response must keep the existing payload format.

Example

GET /sync/tracking/watched/episodes?since=2026-09-25T14:32:19.646Z

If the only episode watched after that timestamp is Pluribus episode 3, the response should contain only that episode record.

Requirements

  • Support since on the existing watched endpoints:

    • /sync/tracking/watched/episodes

    • /sync/tracking/watched/shows

    • /sync/tracking/watched/movies

  • Accept an RFC 3339 timestamp.

  • Return the existing response format without additional fields.

  • Return records whose watch timestamp is later than since.

  • Preserve the current behavior when since is omitted.

  • Keep existing pagination behavior.

  • Support since together with page and limit.

Acceptance criteria

  • A request without since returns the current full watched history.

  • A request with since returns only records watched after that timestamp.

  • The response objects are unchanged.

  • Pagination works correctly on filtered results.

  • Invalid timestamps return a clear 400 Bad Request.

  • The filter works for episode, show, and movie watched history.

1 comment

Log in to comment and vote

Comments1

  • tacolosse

    •

    Oct 19

    This looks covered by the API now (https://api.wetrakr.com/#/sync):

    • from_date on the watched lists returns only what changed since that moment, which is what a sync needs.

    • watched_from / watched_to filter by when you watched. On GET /sync/tracking/watched/history/{movies|episodes} they take a full ISO 8601 moment.

    • GET /sync/last_activities and GET /sync/journal tell a sync tool what moved without fetching full lists.

    If that covers it, maybe this can be marked Completed?