Skip to main content

New features

  • Account endpoints — Manage favorites, watchlists, lists, ratings, and rated TV episodes through a new set of /account/{account_id} endpoints.
  • Authentication endpoints — Create guest sessions, request tokens, and full user sessions (including from v4 tokens or via login), plus a DELETE endpoint to end a session.
  • Certifications endpoints — Fetch the official movie and TV certification lists for use in filtering and ratings displays.
  • Changes endpoints — Track recent updates to movies, TV shows, and people so your integrations can stay in sync.
  • Collections endpoints — Look up collection details, images, and translations.
  • Companies endpoints — Retrieve company details, alternative names, and images.

Updates

  • Cleaner endpoint reference — Every endpoint now includes a description, response codes (200, 401, 404), and grouping tags (Account, Authentication, Certifications, Changes, Collections, Companies) so you can scan the API reference faster.
  • Reusable request schemas — Favorite and watchlist requests now share named schemas (FavoriteRequest, WatchlistRequest) with media_type restricted to movie or tv, making client generation more reliable.
  • Production server URL — The OpenAPI spec now points at https://api.themoviedb.org/3 as the single production server, removing an empty placeholder entry.

Bug fixes

  • account_id path parameter — Account routes previously hard-coded a sample account number in the path (e.g. /account/{22845422}). They now use a proper {account_id} path parameter, so requests work for any authenticated account.
  • Favorite and watchlist movie/TV endpoints — The account_id parameter is now correctly declared as a required path parameter instead of an optional query parameter.