{"openapi":"3.0.2","paths":{"/oauth/authorize":{"get":{"description":"Construct then redirect to this URL. The Trakt website will request permissions for your app, which the user needs to approve. If the user isn't signed into Trakt, it will ask them to do so.\n\n> ### Important\n> _Use the **https://auth.trakt.tv** hostname for all OAuth requests, including authorization, device authentication, token exchange and refresh, and token revocation. Do not use the API hostname for these requests._\n\n#### Optional URL Parameters\n\nWhen building the authorization URL, you can optionally include the following query parameters in the URL.\n\n| Parameter | Value | Description |\n|---|---|---|\n| `signup` | `true` | Prefer the account sign up page to be the default. |\n| `prompt` | `login` | Force the user to sign in and authorize your app. |\n\n#### PKCE\n\n[PKCE](https://developer.trakt.tv/docs/pkce) is the recommended way to sign users in. Send these parameters, then send the matching `code_verifier` instead of a `client_secret` when you exchange the code.\n\n| Parameter | Value | Description |\n|---|---|---|\n| `code_challenge` | string | The base64url-encoded SHA-256 hash of your `code_verifier`. |\n| `code_challenge_method` | `S256` | The only supported method. |\n\n> ### Note\n> _`client_secret` is deprecated in favor of [PKCE](https://developer.trakt.tv/docs/pkce). It is optional, and should only be sent from your own server, never from a website, mobile app, or desktop app._","summary":"Authorize Application","tags":["oauth"],"parameters":[{"name":"response_type","in":"query","schema":{"type":"string"}},{"name":"client_id","in":"query","schema":{"type":"string"}},{"name":"redirect_uri","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"code_challenge","in":"query","schema":{"type":"string"}},{"name":"code_challenge_method","in":"query","schema":{"type":"string","enum":["S256"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[]}],"servers":[{"url":"https://auth.trakt.tv","description":"Authentication"}],"operationId":"getOauthAuthorize"}},"/oauth/device/code":{"post":{"description":"Generate new codes to start the device authentication process. The `device_code` and `interval` will be used later to poll for the `access_token`. The `user_code` and `verification_url` should be presented to the user as mentioned in the flow steps above.\n\n#### QR Code\n\nYou might consider generating a QR code for the user to easily scan on their mobile device. The QR code should use `https://auth.trakt.tv/activate`, which loads the Trakt hosted activation page.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `client_id` * | string | Get this from your app settings. |\n","summary":"Generate new device codes","tags":["oauth","device"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","description":"The client ID of the application. \n You can find it in the application details here: https://app.trakt.tv/settings/apps"}},"required":["client_id"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"device_code":{"type":"string"},"user_code":{"type":"string"},"verification_url":{"type":"string"},"expires_in":{"type":"integer"},"interval":{"type":"integer"}},"required":["device_code","user_code","verification_url","expires_in","interval"]}}}}},"security":[{"traktAPI":[]}],"servers":[{"url":"https://auth.trakt.tv","description":"Authentication"}],"operationId":"postOauthDeviceCode"}},"/oauth/device/token":{"post":{"description":"Use the `device_code` and poll at the `interval` (in seconds) to check if the user has authorized you app. Use `expires_in` to stop polling after that many seconds, and gracefully instruct the user to restart the process. **It is important to poll at the correct interval and also stop polling when expired.**\n\nWhen you receive a `200` success response, save the `access_token` so your app can authenticate the user in methods that require it. The `access_token` is valid for **7 days**. Save and use the `refresh_token` to get a new `access_token` without asking the user to re-authenticate. Check below for all the error codes that you should handle.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `code` * | string | `device_code` from the initial method. |\n| `client_id` * | string | Get this from your app settings. |\n\n#### Status Codes\nThis method will send various HTTP status codes that you should handle accordingly.\n\n| Code | Description |\n|---|---|\n| `200` | Success - *save the `access_token`*\n| `400` | Pending - *waiting for the user to authorize your app*\n| `404` | Not Found - *invalid `device_code`*\n| `409` | Already Used - *user already approved this code*\n| `410` | Expired - *the tokens have expired, restart the process*\n| `418` | Denied - *user explicitly denied this code*\n| `429` | Slow Down - *your app is polling too quickly*","summary":"Poll for the access_token","tags":["oauth","device"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The device code received from the device authorization request."},"client_id":{"type":"string","description":"The client ID of the application. \n You can find it in the application details here: https://app.trakt.tv/settings/apps"},"client_secret":{"type":"string","description":"Deprecated. Only send it from your own server, never from a website, mobile app, or desktop app.","deprecated":true}},"required":["code","client_id"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string"},"expires_in":{"type":"integer"},"refresh_token":{"type":"string","description":"The refresh token to store for the next refresh. It replaces the previous refresh token, which can no longer be used."},"scope":{"type":"string"},"created_at":{"type":"integer"}},"required":["access_token","token_type","expires_in","refresh_token","scope","created_at"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[]}],"servers":[{"url":"https://auth.trakt.tv","description":"Authentication"}],"operationId":"postOauthDeviceToken"}},"/oauth/token":{"post":{"description":"Exchange an OAuth authorization code or refresh token for an access token.\n\nIf you started the flow with [PKCE](https://developer.trakt.tv/docs/pkce), send the `code_verifier`.\n\n> ### Note\n> _`client_secret` is deprecated in favor of [PKCE](https://developer.trakt.tv/docs/pkce). It is optional, and should only be sent from your own server, never from a website, mobile app, or desktop app._\n\n#### Refreshing Tokens\n\nRefresh tokens are single-use. Each successful refresh returns a new `refresh_token` and invalidates the previous one. Store the new `access_token` and `refresh_token` from the response before the next refresh.\n\nIf the exchange cannot be completed, this endpoint returns a `400` response with an OAuth error and description.","summary":"Exchange a token","tags":["oauth"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"client_id":{"type":"string","description":"The client ID of the application. \n You can find it in the application details here: https://app.trakt.tv/settings/apps"},"client_secret":{"type":"string","description":"Deprecated. Only send it from your own server, never from a website, mobile app, or desktop app.","deprecated":true},"redirect_uri":{"type":"string","description":"URI specified in your app settings."},"code":{"type":"string","description":"The code received when trakt redirects the user back to the application."},"grant_type":{"type":"string","description":"Defines how an access token is obtained."},"code_verifier":{"type":"string","description":"The PKCE code verifier whose SHA-256 hash was sent as `code_challenge`. Required when the flow started with a `code_challenge`. See https://developer.trakt.tv/docs/pkce"}},"required":["client_id","redirect_uri","code","grant_type"]},{"type":"object","properties":{"client_id":{"type":"string","description":"The client ID of the application. \n You can find it in the application details here: https://app.trakt.tv/settings/apps"},"client_secret":{"type":"string","description":"Deprecated. Only send it from your own server, never from a website, mobile app, or desktop app.","deprecated":true},"redirect_uri":{"type":"string","description":"URI specified in your app settings."},"refresh_token":{"type":"string","description":"The current refresh token. Refresh tokens are single-use; after a successful exchange, replace it with the new `refresh_token` returned in the response."},"grant_type":{"type":"string","description":"Defines how an access token is obtained."}},"required":["client_id","redirect_uri","refresh_token","grant_type"]}]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string"},"expires_in":{"type":"integer"},"refresh_token":{"type":"string","description":"The refresh token to store for the next refresh. It replaces the previous refresh token, which can no longer be used."},"scope":{"type":"string"},"created_at":{"type":"integer"}},"required":["access_token","token_type","expires_in","refresh_token","scope","created_at"]}}}},"400":{"description":"Bad Request - the token exchange could not be completed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"OAuth error code, such as `invalid_grant`."},"error_description":{"type":"string","description":"Human-readable details about the token exchange failure."}},"required":["error","error_description"],"description":"Bad Request - the token exchange could not be completed."}}}}},"security":[{"traktAPI":[]}],"servers":[{"url":"https://auth.trakt.tv","description":"Authentication"}],"operationId":"postOauthToken"}},"/oauth/revoke":{"post":{"description":"An `access_token` can be revoked when a user signs out of their Trakt account in your app. This is not required, but might improve the user experience so the user doesn't have an unused app connection hanging around.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `token` * | string | A valid OAuth `access_token`. |\n| `client_id` * | string | Get this from your app settings. |\n\n> ### Note\n> _`client_secret` is deprecated in favor of [PKCE](https://developer.trakt.tv/docs/pkce). It is optional, and should only be sent from your own server, never from a website, mobile app, or desktop app._","summary":"Revoke an access_token","tags":["oauth"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"client_id":{"type":"string"},"client_secret":{"type":"string","description":"Deprecated. Only send it from your own server, never from a website, mobile app, or desktop app.","deprecated":true}},"required":["token","client_id"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[]}],"servers":[{"url":"https://auth.trakt.tv","description":"Authentication"}],"operationId":"postOauthRevoke"}},"/calendars/{target}/shows/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns shows airing during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`), and send `start_date` and `days` to define the window.\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get shows","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"group","in":"query","description":"Collapse same-show-same-day episodes into a single card (`full_season` / `multiple_episodes`). Omit for one entry per episode.","schema":{"type":"string","enum":["day"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsShows"}},"/calendars/{target}/shows/new/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns new shows airing their first season during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get new shows","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsNewShows"}},"/calendars/{target}/shows/premieres/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns season premieres airing during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get season premieres","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsSeasonPremieres"}},"/calendars/{target}/shows/finales/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns show finales airing during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get finales","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsFinales"}},"/calendars/{target}/movies/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns movies with a release date during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get movies","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"released":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["released","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsMovies"}},"/calendars/{target}/streaming/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns all movies with a streaming release date during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get streaming releases","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"released":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["released","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsStreaming"}},"/calendars/{target}/dvd/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns DVD and physical media releases during the requested UTC date range. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`).\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get DVD releases","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"released":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["released","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsDvdReleases"}},"/calendars/{target}/media/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns the merged feed of movies and episodes during the requested UTC date range, ordered by availability date. Use `target` to choose the authenticated user calendar (`my`) or the global calendar (`all`), and `type` to narrow to a single media type.\n\nWhen `target` is `all`, the global calendar uses automatic quality filters to reduce incorrect or low-quality entries. As a result, it may not include every matching item in the database, even when that item has complete information. An omitted item may appear later after it meets the filter requirements.","summary":"Get media","tags":["calendars"],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["my","all"]},"description":"Use \"my\" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist.\n Use \"all\" for all items items airing during the specified period."},{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"type","in":"query","description":"Narrow the feed to a single media type. Omit to return both.","schema":{"type":"string","enum":["movie","show"]}},{"name":"group","in":"query","description":"Collapse same-show-same-day episodes into a single card (`full_season` / `multiple_episodes`). Omit for one entry per episode.","schema":{"type":"string","enum":["day"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"released":{"type":"string","nullable":true},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"first_aired":{"type":"string","nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsMedia"}},"/calendars/releases/hot/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns the merged feed of upcoming movies and episodes during the requested UTC date range that are trending or highly anticipated, ordered by availability date. This is the global feed only; use `type` to narrow to a single media type.","summary":"Get hot releases","tags":["calendars"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"type","in":"query","description":"Narrow the feed to a single media type. Omit to return both.","schema":{"type":"string","enum":["movie","show"]}},{"name":"group","in":"query","description":"Collapse same-show-same-day episodes into a single card (`full_season` / `multiple_episodes`). Omit for one entry per episode.","schema":{"type":"string","enum":["day"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"released":{"type":"string","nullable":true},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"first_aired":{"type":"string","nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsReleasesHot"}},"/calendars/releases/hot/premieres/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns upcoming show premieres during the requested UTC date range that are trending or highly anticipated. Curated global feed - daily-cadence formats (soap, talk, news, game shows) and specials are excluded.","summary":"Get hot premieres","tags":["calendars"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsReleasesHotPremieres"}},"/calendars/releases/hot/finales/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns upcoming show finales during the requested UTC date range that are trending or highly anticipated. Curated global feed - daily-cadence formats (soap, talk, news, game shows) and specials are excluded.","summary":"Get hot finales","tags":["calendars"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsReleasesHotFinales"}},"/calendars/releases/hot/new/{start_date}/{days}":{"get":{"description":"#### ✨ Extended Info 🎚 Filters\nReturns upcoming series premieres during the requested UTC date range that are trending or highly anticipated. Curated global feed - daily-cadence formats (soap, talk, news, game shows) and specials are excluded.","summary":"Get hot new shows","tags":["calendars"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"The start date of the calendar. Must be formatted as \"YYYY-MM-DD\"."},{"name":"days","in":"path","required":true,"schema":{"type":"integer"},"description":"The number of days to retrieve."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"first_aired":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale","full_season","multiple_episodes"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["first_aired","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCalendarsReleasesHotNew"}},"/checkin":{"post":{"description":"#### 🔒 OAuth Required\nCheck into a movie or episode. This should be tied to a user action to manually indicate they are watching something. The item will display as *watching* on the site, then automatically switch to *watched* status once the duration has elapsed. A unique history `id` (64-bit integer) will be returned and can be used to reference this checkin directly.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie` or `episode` object. (see examples ->) |\n| `sharing` | object | Control sharing to any connected social networks. (see below ↓) |\n| `message` | string | Message used for sharing. If not sent, it will use the watching string in the user settings. |\n\n#### Sharing\nThe `sharing` object is optional and will apply the user's settings if not sent. If `sharing` is sent, each key will override the user's setting for that social network. Send `true` to post or `false` to not post on the indicated social network. You can see which social networks a user has connected with the [**/users/settings**](/reference/users/settings) method.\n\n| Key | Type |\n|---|---|\n| `twitter` | boolean |\n| `mastodon` | boolean |\n| `tumblr` | boolean |\n\n> ### Note\n> _If a checkin is already in progress, a `409` HTTP status code will returned. The response will contain an `expires_at` timestamp which is when the user can check in again._","summary":"Check into an item","tags":["checkin"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"oneOf":[{"type":"object","properties":{"episode":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}},"nullable":true,"description":"The sharing object is optional and will apply the user's settings if not sent. \n If sharing is sent, each key will override the user's setting for that social network. \n Send true to post or false to not post on the indicated social network.\n You can see which social networks a user has connected with the /users/settings method."},"message":{"type":"string","nullable":true}}},{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true},"episode":{"type":"object","properties":{"number_abs":{"type":"integer"}},"required":["number_abs"],"nullable":true},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}},"nullable":true,"description":"The sharing object is optional and will apply the user's settings if not sent. \n If sharing is sent, each key will override the user's setting for that social network. \n Send true to post or false to not post on the indicated social network.\n You can see which social networks a user has connected with the /users/settings method."},"message":{"type":"string","nullable":true}}},{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"}},"required":["season","number"],"nullable":true},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}},"nullable":true,"description":"The sharing object is optional and will apply the user's settings if not sent. \n If sharing is sent, each key will override the user's setting for that social network. \n Send true to post or false to not post on the indicated social network.\n You can see which social networks a user has connected with the /users/settings method."},"message":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"],"nullable":true},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}},"nullable":true,"description":"The sharing object is optional and will apply the user's settings if not sent. \n If sharing is sent, each key will override the user's setting for that social network. \n Send true to post or false to not post on the indicated social network.\n You can see which social networks a user has connected with the /users/settings method."},"message":{"type":"string","nullable":true}}}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}}},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]}},"required":["season","number","title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["title","year","ids"],"nullable":true}},"required":["id","watched_at","sharing"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"sharing":{"type":"object","properties":{"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true}}},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]}},"required":["title","year","ids"],"nullable":true}},"required":["id","watched_at","sharing"]}]}}}},"409":{"description":"409","content":{"application/json":{"schema":{"type":"object","properties":{"expires_at":{"type":"string","description":"Timestamp which is when the user can check in again."}},"required":["expires_at"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postCheckinStart"},"delete":{"description":"#### 🔒 OAuth Required\nRemoves any active checkins, no need to provide a specific item. The elapsed progress is saved as paused playback, so the next checkin of the same item resumes from it.","summary":"Delete any active checkins","tags":["checkin"],"parameters":[],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteCheckinDelete"}},"/users/settings":{"get":{"description":"#### 🔒 OAuth Required\nGet the user's settings so you can align your app's experience with what they're used to on the trakt website. A globally unique `uuid` is also returned, which can be used to identify the user locally in your app if needed. However, the `uuid` can't be used to retrieve data from the Trakt API.\n\n#### Limits\n\nThe `limits` object is useful to customize your user experience. For example, if the user has a `list` limit of `2`, you might want to show a message to the user that they need to upgrade to [**Trakt VIP**](https://app.trakt.tv/vip) to add more lists.\n\n#### Permissions\n\nThe `permissions` object is also useful to customize your user experience. In general, an account will have permissions to do everything. However, we'll temporarily set a permission to `false` if the user triggers spam protections.","summary":"Retrieve settings","tags":["users"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"email":{"type":"string"},"username":{"type":"string"},"private":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean"},"vip_ep":{"type":"boolean"},"director":{"type":"boolean"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer","nullable":true},"uuid":{"type":"string"}},"required":["slug","uuid"]},"joined_at":{"type":"string"},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"]},"vip_og":{"type":"boolean"},"vip_years":{"type":"integer"},"vip_cover_image":{"type":"string","nullable":true},"dob":{"type":"string","nullable":true}},"required":["email","username","private","vip","vip_ep","director","ids","joined_at","images","vip_og","vip_years"]},"permissions":{"type":"object","properties":{"commenting":{"type":"boolean"},"liking":{"type":"boolean"},"following":{"type":"boolean"}},"required":["commenting","liking","following"]},"browsing":{"type":"object","properties":{"watch_popup_action":{"type":"string","enum":["now","ask","released","unknown"],"nullable":true},"hide_watching_now":{"type":"boolean"},"list_popup_action":{"type":"string","nullable":true},"week_start_day":{"type":"string","nullable":true},"watch_after_rating":{"type":"string","nullable":true},"watch_only_once":{"type":"boolean"},"show_rating_prompt":{"type":"boolean","nullable":true},"locale":{"type":"string","nullable":true},"other_site_ratings":{"type":"boolean"},"release_date_ignore_runtime":{"type":"boolean"},"display_early_ratings":{"type":"boolean"},"hide_episode_type_tags":{"type":"boolean"},"hide_unsaved_filters_prompt":{"type":"boolean"},"spoilers":{"type":"object","properties":{"episodes":{"type":"string","nullable":true},"shows":{"type":"string","nullable":true},"movies":{"type":"string","nullable":true},"comments":{"type":"string","nullable":true},"ratings":{"type":"string","nullable":true},"actors":{"type":"string","nullable":true}}},"calendar":{"type":"object","properties":{"period":{"type":"string","nullable":true},"start_day":{"type":"string","nullable":true},"layout":{"type":"string","nullable":true},"image_type":{"type":"string","nullable":true},"hide_specials":{"type":"boolean"},"autoscroll":{"type":"boolean"}},"required":["hide_specials","autoscroll"]},"progress":{"type":"object","properties":{"on_deck":{"type":"object","properties":{"sort":{"type":"string","enum":["activity","added","completed","episodes","time","plays","released","premiered","title","popularity","runtime","total-runtime","recently-aired","random","most-completed","least-completed","most-time","least-time","most-plays","least-plays","most-episodes","least-episodes","oldest-activity","previously-aired"],"nullable":true},"sort_how":{"type":"string","enum":["asc","desc"]},"refresh":{"type":"boolean"},"simple_progress":{"type":"boolean"},"only_favorites":{"type":"boolean"}},"required":["sort_how","refresh","simple_progress","only_favorites"]},"watched":{"type":"object","properties":{"refresh":{"type":"boolean"},"simple_progress":{"type":"boolean"},"include_specials":{"type":"boolean"},"include_watchlisted":{"type":"boolean"},"include_collected":{"type":"boolean"},"sort":{"type":"string","nullable":true},"sort_how":{"type":"string","enum":["asc","desc"]},"use_last_activity":{"type":"boolean"},"grid_view":{"type":"boolean"}},"required":["refresh","simple_progress","include_specials","include_watchlisted","include_collected","sort_how","use_last_activity","grid_view"]},"collected":{"type":"object","properties":{"refresh":{"type":"boolean"},"simple_progress":{"type":"boolean"},"include_specials":{"type":"boolean"},"include_watchlisted":{"type":"boolean"},"include_watched":{"type":"boolean"},"sort":{"type":"string","nullable":true},"sort_how":{"type":"string","enum":["asc","desc"]},"use_last_activity":{"type":"boolean"},"grid_view":{"type":"boolean"}},"required":["refresh","simple_progress","include_specials","include_watchlisted","include_watched","sort_how","use_last_activity","grid_view"],"nullable":true}},"required":["on_deck","watched"]},"watchnow":{"type":"object","properties":{"country":{"type":"string","nullable":true},"favorites":{"type":"array","items":{"type":"string"}},"only_favorites":{"type":"boolean"}},"required":["favorites","only_favorites"]},"dark_knight":{"type":"string","nullable":true},"app_theme":{"type":"string","nullable":true},"welcome":{"type":"object","properties":{"completed_at":{"type":"string","nullable":true},"exit_step":{"type":"string","format":"null","nullable":true}},"required":["exit_step"]},"genres":{"type":"object","properties":{"favorites":{"type":"array","items":{"type":"string"},"nullable":true},"disliked":{"type":"array","items":{"type":"string"},"nullable":true}}},"comments":{"type":"object","properties":{"blocked_uids":{"type":"array","items":{"type":"integer"}}},"required":["blocked_uids"]},"recommendations":{"type":"object","properties":{"ignore_collected":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"}},"required":["ignore_collected","ignore_watchlisted"]},"rewatching":{"type":"object","properties":{"adjust_percentage":{"type":"boolean"}},"required":["adjust_percentage"]},"profile":{"type":"object","properties":{"favorites":{"type":"object","properties":{"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]}},"required":["sort_by","sort_how"]},"most_watched_shows":{"type":"object","properties":{"sort_by":{"type":"string"},"tab":{"type":"string"}},"required":["sort_by","tab"]},"most_watched_movies":{"type":"object","properties":{"sort_by":{"type":"string"},"tab":{"type":"string"}},"required":["sort_by","tab"]}},"required":["favorites","most_watched_shows","most_watched_movies"]},"search":{"type":"object","properties":{"image_type":{"type":"string","nullable":true},"recent_queries":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"integer"}},"required":["query","type","created_at"]}}},"required":["recent_queries"],"nullable":true}},"required":["hide_watching_now","watch_only_once","other_site_ratings","release_date_ignore_runtime","display_early_ratings","hide_episode_type_tags","hide_unsaved_filters_prompt","spoilers","calendar","progress","watchnow","welcome","genres","comments","recommendations","rewatching","profile"],"nullable":true},"account":{"type":"object","properties":{"timezone":{"type":"string"},"date_format":{"type":"string"},"time_24hr":{"type":"boolean"},"cover_image":{"type":"string","nullable":true},"token":{"type":"string","nullable":true},"share_code":{"type":"string","nullable":true},"display_ads":{"type":"boolean","nullable":true}},"required":["timezone","date_format","time_24hr"]},"connections":{"type":"object","properties":{"facebook":{"type":"boolean","nullable":true},"twitter":{"type":"boolean","nullable":true},"mastodon":{"type":"boolean","nullable":true},"google":{"type":"boolean","nullable":true},"tumblr":{"type":"boolean","nullable":true},"medium":{"type":"boolean","nullable":true},"slack":{"type":"boolean","nullable":true},"apple":{"type":"boolean","nullable":true},"dropbox":{"type":"boolean","nullable":true},"microsoft":{"type":"boolean","nullable":true}},"nullable":true},"sharing_text":{"type":"object","properties":{"watching":{"type":"string"},"watched":{"type":"string"},"rated":{"type":"string","nullable":true}},"required":["watching","watched"],"nullable":true},"limits":{"type":"object","properties":{"list":{"type":"object","properties":{"count":{"type":"integer"},"item_count":{"type":"integer"}},"required":["count","item_count"]},"watchlist":{"type":"object","properties":{"item_count":{"type":"integer"}},"required":["item_count"]},"favorites":{"type":"object","properties":{"item_count":{"type":"integer"}},"required":["item_count"]}},"required":["list","watchlist","favorites"],"nullable":true}},"required":["user","permissions","account"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSettings"},"put":{"description":"#### 🔒 OAuth Required\nUpdate settings for the authenticated user. Send the settings request body with the values to change; a successful update returns no response body.","summary":"Update settings","tags":["users"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"name":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"private":{"type":"boolean","nullable":true},"dob":{"type":"string","nullable":true}},"nullable":true},"browsing":{"type":"object","properties":{"genres":{"type":"object","properties":{"favorites":{"type":"array","items":{"type":"string"},"nullable":true},"disliked":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"spoilers":{"type":"object","properties":{"episodes":{"type":"string","enum":["show","hide"],"nullable":true},"shows":{"type":"string","enum":["show","hide"],"nullable":true},"movies":{"type":"string","enum":["show","hide"],"nullable":true}},"nullable":true},"watchnow":{"type":"object","properties":{"country":{"type":"string","nullable":true},"favorites":{"type":"array","items":{"type":"string"},"nullable":true},"only_favorites":{"type":"boolean","nullable":true}},"nullable":true},"dark_knight":{"type":"string","enum":["true","false","auto"],"nullable":true},"watch_only_once":{"type":"boolean","nullable":true},"show_rating_prompt":{"type":"boolean","nullable":true},"locale":{"type":"string","nullable":true}},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersSaveSettings"}},"/users/reactions/comments":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns comments the authenticated user has reacted to. Use `extended`, `page`, and `limit` to control returned comment detail and pagination.","summary":"Get comment reactions","tags":["users","reactions"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"reacted_at":{"type":"string"},"reaction":{"type":"object","properties":{"type":{"type":"string","enum":["like","dislike","love","laugh","shocked","bravo","spoiler"]}},"required":["type"]},"type":{"type":"string","enum":["comment"]},"comment":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id"]}},"required":["reacted_at","reaction","type","comment"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersReactionsComments"}},"/users/{id}/likes/{type}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns likes for a user filtered by type.","summary":"Get likes","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"User media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"allOf":[{"type":"object","properties":{"liked_at":{"type":"string"},"type":{"type":"string","enum":["comment"]},"comment":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id"],"nullable":true}},"required":["liked_at","type"]},{"oneOf":[{"type":"object","properties":{"comment_type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}}},{"type":"object","properties":{"comment_type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}}},{"type":"object","properties":{"comment_type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true}}},{"type":"object","properties":{"comment_type":{"type":"string","enum":["season"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true}}}]}]},{"type":"object","properties":{"liked_at":{"type":"string"},"type":{"type":"string","enum":["list"]},"list":{"oneOf":[{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}}},{"type":"object","properties":{"id":{"type":"integer","nullable":true}}}],"nullable":true}},"required":["liked_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersLikes"}},"/users/avatar":{"put":{"description":"#### 🫣 Limited Access 🔒 OAuth Required\nThis endpoint is currently available only to first-party Trakt applications. Third-party applications receive a `401` response even with a valid OAuth token.\n\nUpdate the authenticated user avatar. Send the avatar request body; a successful update returns a `204` response, and invalid image data returns `400`.","summary":"Update avatar","tags":["users"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"avatar":{"type":"string"}},"required":["avatar"]}},"required":["user"]}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersAvatar"},"delete":{"description":"#### 🫣 Limited Access 🔒 OAuth Required\nThis endpoint is currently available only to first-party Trakt applications. Third-party applications receive a `401` response even with a valid OAuth token.\n\nRemove the authenticated user avatar. A successful removal returns a `204` response; the profile then falls back to the default avatar.","summary":"Remove avatar","tags":["users"],"parameters":[],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersRemoveAvatar"}},"/users/set_cover":{"put":{"description":"#### 🫣 Limited Access 🔒 OAuth Required\nThis endpoint is currently available only to first-party Trakt applications. Third-party applications receive a `401` response even with a valid OAuth token.\n\nUpdate the authenticated user cover image. Send the cover request body; a successful update returns a `204` response, and invalid image data returns `400`.","summary":"Update cover image","tags":["users"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"cover_type":{"type":"string","enum":["movie","show","episode"]},"cover_id":{"type":"integer"}},"required":["cover_type","cover_id"]}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersCover"}},"/users/blocked":{"get":{"description":"#### 🔒 OAuth Required\nReturns all users you have blocked, including when each user was blocked.","summary":"Get blocked users","tags":["users"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"blocked_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["blocked_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersBlocked"}},"/users/syncs/":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination\nPaginated list of the authenticated user's data syncs across **every** connected app (younify, plex, importers). Counts only — the paused/skipped item arrays are served by the dedicated paginated endpoints.\n\nPagination is via `page` / `limit` and the standard `X-Pagination-*` headers. `X-Pagination-Item-Count` is the total sync count (use it for the \"Data has synced N times\" banner). All timestamps are normalized to `.000Z`.","summary":"Get data syncs","tags":["users","syncs"],"parameters":[{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","description":"When the sync ran, normalized to `.000Z`."},"kind":{"type":"string","enum":["younify","plex","import"]},"source":{"type":"string","nullable":true,"description":"Streaming service / importer source (`netflix`, `plex`, `csv`, …), or null."},"application":{"type":"string","nullable":true,"description":"Name of the OAuth app that created the sync; null for `application_id 0` importers."},"undone":{"type":"boolean"},"undone_at":{"type":"string","nullable":true,"description":"When the sync was reversed, normalized to `.000Z`, or null."},"items":{"type":"object","properties":{"history":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"library":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"ratings":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"watchlist":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}}},"description":"Added counts per section. Empty sections and media types are omitted."},"paused_count":{"type":"integer"},"skipped_count":{"type":"integer"}},"required":["id","created_at","kind","source","application","undone","undone_at","items","paused_count","skipped_count"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSyncsList"}},"/users/syncs/{type}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination\nSame as the list of data syncs, filtered by the app that created them. The `type` matches the `kind` returned on each row (`younify`, `plex`, or `import` for anything else, including `application_id 0` importers).\n\nAn unknown `type` returns `404` rather than silently returning everything. Pagination and `X-Pagination-*` headers are identical to the unfiltered list.","summary":"Get data syncs by type","tags":["users","syncs"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["younify","plex","import"]},"description":"Filter syncs by the app that created them. An unknown type returns `404` rather than silently returning everything."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","description":"When the sync ran, normalized to `.000Z`."},"kind":{"type":"string","enum":["younify","plex","import"]},"source":{"type":"string","nullable":true,"description":"Streaming service / importer source (`netflix`, `plex`, `csv`, …), or null."},"application":{"type":"string","nullable":true,"description":"Name of the OAuth app that created the sync; null for `application_id 0` importers."},"undone":{"type":"boolean"},"undone_at":{"type":"string","nullable":true,"description":"When the sync was reversed, normalized to `.000Z`, or null."},"items":{"type":"object","properties":{"history":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"library":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"ratings":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"watchlist":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}}},"description":"Added counts per section. Empty sections and media types are omitted."},"paused_count":{"type":"integer"},"skipped_count":{"type":"integer"}},"required":["id","created_at","kind","source","application","undone","undone_at","items","paused_count","skipped_count"]}}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSyncsListByType"}},"/users/syncs/{id}":{"get":{"description":"#### 🔒 OAuth Required\nReturns a single sync scoped to the authenticated user — foreign ids return `404`. Same shape as a list row: added counts plus `paused_count` / `skipped_count`, no item arrays.\n\nA numeric segment (`/users/syncs/157`) hits this endpoint; a non-numeric segment (`/users/syncs/younify`) is the filtered list.","summary":"Get a data sync","tags":["users","syncs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"created_at":{"type":"string","description":"When the sync ran, normalized to `.000Z`."},"kind":{"type":"string","enum":["younify","plex","import"]},"source":{"type":"string","nullable":true,"description":"Streaming service / importer source (`netflix`, `plex`, `csv`, …), or null."},"application":{"type":"string","nullable":true,"description":"Name of the OAuth app that created the sync; null for `application_id 0` importers."},"undone":{"type":"boolean"},"undone_at":{"type":"string","nullable":true,"description":"When the sync was reversed, normalized to `.000Z`, or null."},"items":{"type":"object","properties":{"history":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"library":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"ratings":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}},"watchlist":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"}}}},"description":"Added counts per section. Empty sections and media types are omitted."},"paused_count":{"type":"integer"},"skipped_count":{"type":"integer"}},"required":["id","created_at","kind","source","application","undone","undone_at","items","paused_count","skipped_count"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSyncsDetails"},"delete":{"description":"#### 🔒 OAuth Required\nUndoes a sync — reverses every item it imported (history, ratings, paused, watchlist, collection) and marks it undone. Scoped to the authenticated user; a foreign sync returns `404`.","summary":"Undo a data sync","tags":["users","syncs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersSyncsUndo"}},"/users/syncs/{id}/paused":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination\nPaginated item array for a sync, scoped to the authenticated user — foreign ids return `404`. Split out because a single sync can hold thousands of items.\n\nPaused items are always `history` (their `kind` is always `\"history\"`). Each item is the raw stored item (so source-specific fields are preserved) plus a normalized envelope, with timestamps normalized to `.000Z`. Pagination and `X-Pagination-*` headers are identical to the list endpoint.","summary":"Get paused sync items","tags":["users","syncs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["history","rating"],"description":"Discriminator. `skipped` mixes `history` and `rating`; `paused` is always `history`."},"type":{"type":"string","enum":["movie","episode","show"],"nullable":true,"description":"Resolved media type, or null when it could not be derived from the available ids."},"trakt_item":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["movie"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt","slug","imdb","tmdb"]}},"required":["type","title","year","ids"]},{"type":"object","properties":{"type":{"type":"string","enum":["show"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["type","title","year","ids"]},{"type":"object","properties":{"type":{"type":"string","enum":["episode"]},"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true}},"required":["trakt","tmdb"]},"show":{"type":"object","properties":{"type":{"type":"string","enum":["show"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["type","title","year","ids"],"nullable":true}},"required":["type","season","number","title","ids","show"]}],"nullable":true,"description":"Resolved trakt object when a tmdb id matches, null otherwise."},"service_id":{"type":"string","nullable":true},"content_id":{"type":"string","nullable":true},"profile_id":{"type":"string","nullable":true},"tmdb_id":{"type":"integer","nullable":true},"tmdb_series_id":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"History timestamp, normalized to `.000Z`."},"rated_at":{"type":"string","nullable":true,"description":"Rating timestamp, normalized to `.000Z`."},"progress":{"type":"number","format":"float","nullable":true},"rating_type":{"type":"string","nullable":true},"rating_value":{"type":"integer","nullable":true}},"required":["kind","type","trakt_item"],"additionalProperties":true}}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSyncsPaused"}},"/users/syncs/{id}/skipped":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination\nPaginated item array for a sync, scoped to the authenticated user — foreign ids return `404`. Split out because a single sync can hold thousands of items.\n\nSkipped items mix `history` and `rating` (see each item's `kind` discriminator). Each item is the raw stored item (so source-specific fields are preserved) plus a normalized envelope, with timestamps normalized to `.000Z`. Pagination and `X-Pagination-*` headers are identical to the list endpoint.","summary":"Get skipped sync items","tags":["users","syncs"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["history","rating"],"description":"Discriminator. `skipped` mixes `history` and `rating`; `paused` is always `history`."},"type":{"type":"string","enum":["movie","episode","show"],"nullable":true,"description":"Resolved media type, or null when it could not be derived from the available ids."},"trakt_item":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["movie"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt","slug","imdb","tmdb"]}},"required":["type","title","year","ids"]},{"type":"object","properties":{"type":{"type":"string","enum":["show"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["type","title","year","ids"]},{"type":"object","properties":{"type":{"type":"string","enum":["episode"]},"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true}},"required":["trakt","tmdb"]},"show":{"type":"object","properties":{"type":{"type":"string","enum":["show"]},"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["type","title","year","ids"],"nullable":true}},"required":["type","season","number","title","ids","show"]}],"nullable":true,"description":"Resolved trakt object when a tmdb id matches, null otherwise."},"service_id":{"type":"string","nullable":true},"content_id":{"type":"string","nullable":true},"profile_id":{"type":"string","nullable":true},"tmdb_id":{"type":"integer","nullable":true},"tmdb_series_id":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"History timestamp, normalized to `.000Z`."},"rated_at":{"type":"string","nullable":true,"description":"Rating timestamp, normalized to `.000Z`."},"progress":{"type":"number","format":"float","nullable":true},"rating_type":{"type":"string","nullable":true},"rating_value":{"type":"integer","nullable":true}},"required":["kind","type","trakt_item"],"additionalProperties":true}}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSyncsSkipped"}},"/users/settings/plex/":{"get":{"description":"#### 🔒 OAuth Required\nReturns the authenticated user's Plex connection status, real-time scrobbler webhook info, server/library/home-user selection, and both toggle sets (batch `sync` + real-time `scrobbler`). Read-only, though the VIP webhook URL lazily mints its tokens.\n\n`connection.connected` reflects that a Plex authorization exists; for a live auth check call `servers` and watch for a `bad_auth` error. `webhook.url` is null unless the user is VIP. `sync.configured` indicates the initial sync has been set up. Toggles are booleans (unset ⇒ `false`); sync toggles include `watching`/`watchlist`, scrobbler toggles do not carry `watchlist`. All timestamps are normalized to `.000Z`.","summary":"Get Plex settings","tags":["users","plex"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"connection":{"type":"object","properties":{"connected":{"type":"boolean","description":"Whether a Plex authorization exists."},"username":{"type":"string","nullable":true,"description":"The stored Plex uid (currently usually null)."}},"required":["connected","username"]},"webhook":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"The real-time scrobbler webhook URL; null unless the user is VIP."},"last_event_at":{"type":"string","nullable":true,"description":"When the webhook last fired, normalized to `.000Z`, or null."},"event_count":{"type":"integer"},"home_users":{"type":"string","nullable":true,"description":"Comma-separated Plex home usernames to scrobble for."}},"required":["url","last_event_at","event_count","home_users"]},"sync":{"type":"object","properties":{"configured":{"type":"boolean","description":"Whether the initial sync has been set up."},"error":{"type":"boolean","description":"Whether a persisted Plex-sync error is currently active."},"server_limit":{"type":"integer","nullable":true,"description":"Max number of Plex servers this user may sync. null = unlimited (VIP), 1 = free."},"selection":{"type":"object","properties":{"server_ids":{"type":"array","items":{"type":"string"}},"library_ids":{"type":"array","items":{"type":"object","properties":{"server_id":{"type":"string"},"uuid":{"type":"string"}},"required":["server_id","uuid"]}},"user_ids":{"type":"array","items":{"type":"string"}}},"required":["server_ids","library_ids","user_ids"]},"toggles":{"type":"object","properties":{"movie":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"},"watchlist":{"type":"boolean"}},"required":["watching","watched","rated","collected","watchlist"]},"show":{"type":"object","properties":{"rated":{"type":"boolean"},"watchlist":{"type":"boolean"}},"required":["rated","watchlist"]},"season":{"type":"object","properties":{"rated":{"type":"boolean"}},"required":["rated"]},"episode":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}},"required":["watching","watched","rated","collected"]}},"required":["movie","show","season","episode"],"description":"Batch-sync toggles (unset ⇒ false). Includes `watching`/`watchlist`."}},"required":["configured","error","server_limit","selection","toggles"]},"scrobbler":{"type":"object","properties":{"toggles":{"type":"object","properties":{"movie":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}},"required":["watching","watched","rated","collected"]},"show":{"type":"object","properties":{"rated":{"type":"boolean"}},"required":["rated"]},"season":{"type":"object","properties":{"rated":{"type":"boolean"}},"required":["rated"]},"episode":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}},"required":["watching","watched","rated","collected"]}},"required":["movie","show","season","episode"],"description":"Real-time scrobbler toggles (unset ⇒ false). No `watchlist`."}},"required":["toggles"]}},"required":["connection","webhook","sync","scrobbler"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersPlexSettings"},"put":{"description":"#### 🔒 OAuth Required\nWrites the Plex toggles, selection, and home users. Mirrors the GET shape so it round-trips; omitted toggle keys are left unchanged (no clobbering), and `library_ids` is sent structured and rebuilt into the `server|uuid` storage server-side.\n\nThe optional `trigger_sync` block is the only thing that touches sync timestamps or enqueues work: any `*_all_data: true` resets the affected cursors and enqueues a full sync per selected server; present-but-all-false seeds every cursor to \"now\" (the first sync skips old history); absent writes settings without syncing.","summary":"Update Plex settings","tags":["users","plex"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"sync":{"type":"object","properties":{"selection":{"type":"object","properties":{"server_ids":{"type":"array","items":{"type":"string"}},"library_ids":{"type":"array","items":{"type":"object","properties":{"server_id":{"type":"string"},"uuid":{"type":"string"}},"required":["server_id","uuid"]}},"user_ids":{"type":"array","items":{"type":"string"}}}},"toggles":{"type":"object","properties":{"movie":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"},"watchlist":{"type":"boolean"}}},"show":{"type":"object","properties":{"rated":{"type":"boolean"},"watchlist":{"type":"boolean"}}},"season":{"type":"object","properties":{"rated":{"type":"boolean"}}},"episode":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}}}}}}},"scrobbler":{"type":"object","properties":{"toggles":{"type":"object","properties":{"movie":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}}},"show":{"type":"object","properties":{"rated":{"type":"boolean"}}},"season":{"type":"object","properties":{"rated":{"type":"boolean"}}},"episode":{"type":"object","properties":{"watching":{"type":"boolean"},"watched":{"type":"boolean"},"rated":{"type":"boolean"},"collected":{"type":"boolean"}}}}}}},"webhook":{"type":"object","properties":{"home_users":{"type":"string","nullable":true,"description":"Comma-separated Plex home usernames to scrobble for."}}},"trigger_sync":{"type":"object","properties":{"watched_all_data":{"type":"boolean"},"collection_all_data":{"type":"boolean"},"ratings_all_data":{"type":"boolean"},"watchlist_all_data":{"type":"boolean"}},"description":"Optional. Only this block touches sync timestamps/enqueues work: any `*_all_data: true` resets the affected cursors and enqueues a full sync per selected server; present-but-all-false seeds every cursor to \"now\" (first sync skips old history); absent writes settings without syncing."}}}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersPlexUpdateSettings"}},"/users/settings/plex/connect":{"post":{"description":"#### 🔒 OAuth Required\nMints a Plex web-auth URL for the client to open. Plex uses a 2-step PIN OAuth; the PIN is stashed server-side under an opaque `state` token and Plex is forwarded to a website return endpoint that exchanges it and redirects back to your `return_url` with `?plex_status=connected|error`.\n\n`return_url` is validated against the trakt-owned allowlist (`trakt://`, `http(s)://localhost`, `https://*.trakt.tv`); a `400` is returned otherwise.","summary":"Connect Plex","tags":["users","plex"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"return_url":{"type":"string","description":"Where to return the user once the Plex web-auth flow completes. Must be a trakt-owned destination (`trakt://…`, `http(s)://localhost`, or `https://*.trakt.tv`); the flow appends `?plex_status=connected|error`."}},"required":["return_url"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The Plex web-auth URL for the client to open."}},"required":["url"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersPlexConnect"},"delete":{"description":"#### 🔒 OAuth Required\nDisconnects Plex: destroys the authorization, clears server/library/user selection and sync state, and busts the connection caches.","summary":"Disconnect Plex","tags":["users","plex"],"parameters":[],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersPlexDisconnect"}},"/users/settings/plex/servers":{"get":{"description":"#### 🔒 OAuth Required\nLists the authenticated user's Plex servers. Network-bound — probes each server's remote URL. On a Plex/auth failure it returns the shared `{ error_code, message, guidance }` envelope: `bad_auth` (401), `plex_timeout` (504), `plex_bad_response`/`plex_generic_error` (502).","summary":"Get Plex servers","tags":["users","plex"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"servers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"connection_count":{"type":"integer"},"connection_timeout":{"type":"integer","description":"Worst-case probe timeout across the server connections, in seconds."},"ports":{"type":"array","items":{"type":"integer"}},"owned":{"type":"boolean"},"url":{"type":"string","nullable":true,"description":"The resolved remote URL, or null when the server is unreachable."}},"required":["id","name","connection_count","connection_timeout","ports","owned","url"]}}},"required":["servers"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"504":{"description":"504","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersPlexServers"}},"/users/settings/plex/servers/{server_id}":{"get":{"description":"#### 🔒 OAuth Required\nReturns the home accounts (owned servers only) and syncable libraries for a Plex server, with the user's current library selection flagged. Network-bound.\n\nErrors use the shared `{ error_code, message, guidance }` envelope: `missing_token`/`bad_auth` (401), `missing_server_id`/`plex_unprocessable` (422), `invalid_server_id`/`plex_not_found` (404), `invalid_server_url` (503), `plex_timeout` (504), `plex_bad_response`/`plex_generic_error` (502).","summary":"Get Plex server accounts and libraries","tags":["users","plex"],"parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"string"},"description":"The Plex server machine identifier."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"]},"description":"Home accounts on the server; empty for servers the user does not own."},"libraries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"uuid":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"agent":{"type":"string"},"scanner":{"type":"string"},"selected":{"type":"boolean","description":"Whether this library is in the user's current sync selection."},"url":{"type":"string"}},"required":["id","uuid","type","title","agent","scanner","selected","url"]}}},"required":["accounts","libraries"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"503":{"description":"503","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}},"504":{"description":"504","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","description":"Machine-readable error code (e.g. `bad_auth`, `invalid_server_url`, `plex_timeout`)."},"message":{"type":"string"},"guidance":{"type":"string"}},"required":["error_code","message","guidance"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersPlexServerAccounts"}},"/users/settings/plex/sync":{"post":{"description":"#### 🔒 OAuth Required\nEnqueues a Plex sync immediately. With `server_id`, syncs that server; without it, syncs every server in the saved selection. `all_data: true` re-pulls full history, otherwise an incremental sync. A `422` is returned when there is no server to sync.","summary":"Sync Plex now","tags":["users","plex"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"server_id":{"type":"string","description":"Sync this server; omit to sync every server in the saved selection."},"all_data":{"type":"boolean","description":"When true, re-pulls full history; otherwise an incremental sync."}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"422":{"description":"422","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersPlexSync"}},"/users/{id}/":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nGet a user's profile information. If the user is private, info will only be returned if you send OAuth and are either that user or an approved follower. Adding `?extended=vip` will return some additional VIP related fields so you can display the user's Trakt VIP status and year count.","summary":"Get user profile","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersProfile"}},"/users/{id}/{type}/activities":{"get":{"description":"#### 🫣 Limited Access 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nThis endpoint is currently available only to first-party Trakt applications. Third-party applications receive a `403` response.\n\nReturns the last 7 days of watch activity from a user's social graph, newest first. Use `type` to choose `friends`, `followers`, or `following`, and use pagination to move through the activity feed.\n\nActivity from a private user is only included when you follow them. Set `?extended=rating` to include each person's `user_rating` for the item they watched.","summary":"Get social activity","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["friends","followers","following"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"activity_at":{"type":"string"},"action":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"user_rating":{"type":"integer","nullable":true},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","activity_at","action","user","type"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"activity_at":{"type":"string"},"action":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"user_rating":{"type":"integer","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","activity_at","action","user","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersActivities"}},"/users/{id}/stats":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional\nReturns stats about the movies, shows, and episodes a user has watched, collected, and rated.\n\nStats are precomputed for VIP users only. Returns `204 No Content` when no precomputed stats are available.","summary":"Get stats","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"seasons":{"type":"object","properties":{"ratings":{"type":"integer"},"comments":{"type":"integer"}},"required":["ratings","comments"]},"shows":{"type":"object","properties":{"ratings":{"type":"integer"},"comments":{"type":"integer"},"watched":{"type":"integer"},"collected":{"type":"integer"}},"required":["ratings","comments","watched","collected"]},"movies":{"type":"object","properties":{"ratings":{"type":"integer"},"comments":{"type":"integer"},"watched":{"type":"integer"},"collected":{"type":"integer"},"plays":{"type":"integer"},"minutes":{"type":"integer"}},"required":["ratings","comments","watched","collected","plays","minutes"]},"episodes":{"type":"object","properties":{"ratings":{"type":"integer"},"comments":{"type":"integer"},"watched":{"type":"integer"},"collected":{"type":"integer"},"plays":{"type":"integer"},"minutes":{"type":"integer"}},"required":["ratings","comments","watched","collected","plays","minutes"]},"network":{"type":"object","properties":{"friends":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"}},"required":["friends","followers","following"]},"ratings":{"type":"object","properties":{"total":{"type":"integer"},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"]}},"required":["total","distribution"]},"progress":{"type":"object","properties":{"started":{"type":"integer"},"finished":{"type":"integer"},"dropped":{"type":"integer"}},"required":["started","finished","dropped"],"nullable":true},"lists":{"type":"integer","nullable":true},"total_minutes":{"type":"integer","nullable":true},"total_plays":{"type":"integer","nullable":true}},"required":["seasons","shows","movies","episodes","network","ratings"]}}}},"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersStats"}},"/users/{id}/comments/{comment_type}/{type}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns the most recently written comments for the user. You can optionally filter by the `comment_type` and media `type` to limit what gets returned.\n\nBy default, only top level comments are returned. Set `?include_replies=true` to return replies in addition to top level comments. Set `?include_replies=only` to return only replies and no top level comments.","summary":"Get comments","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"comment_type","in":"path","required":true,"schema":{"type":"string","enum":["all","reviews","shouts"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","movies","shows","seasons","episodes","lists"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"include_replies","in":"query","schema":{"type":"string","enum":["true","false","only"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["movie","show","season","episode"]},"comment":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true}},"required":["type","comment"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersComments"}},"/users/{id}/collection/{type}":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns collection items for a user filtered by type.","summary":"Get collection","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"User media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"collected_at":{"type":"string"}},"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersCollection"}},"/users/{id}/notes/{type}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 😁 Emojis\nReturns notes for a user filtered by type.","summary":"Get notes","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"User media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"notes":{"type":"string","nullable":true},"privacy":{"type":"string"},"spoiler":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersNotes"}},"/users/{id}/watching":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns a movie or episode if the user is currently watching something. If they are not, it returns no data and a `204` HTTP status code.","summary":"Get watching","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"expires_at":{"type":"string"},"started_at":{"type":"string"},"action":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["expires_at","started_at","action","type"]},{"type":"object","properties":{"expires_at":{"type":"string"},"started_at":{"type":"string"},"action":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["expires_at","started_at","action","type"]}]}}}},"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatching"}},"/users/{id}/follow":{"post":{"description":"#### 🔒 OAuth Required\nIf the user has a private profile, the follow request will require approval (`approved_at` will be null). If a user is public, they will be followed immediately (`approved_at` will have a date).\n\n> ### Note\n> _If this user is already being followed or there is a pending follow request, a `409` HTTP status code will returned._","summary":"Follow this user","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"approved_at":{"type":"string","nullable":true},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["user"]}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersFollow"},"delete":{"description":"#### 🔒 OAuth Required\nUnfollow someone you already follow.","summary":"Unfollow this user","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersUnfollow"}},"/users/{id}/block":{"post":{"description":"#### 🔒 OAuth Required\nBlock a user. If they are already following you, they will be removed from your followers. Any pending follow request from this user will be blocked, preventing them from following you in the future until you unblock them.\n\n> ### Note\n> _If the user is already blocked, or you try to block yourself, a `409` HTTP status code will be returned._","summary":"Block this user","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersBlock"},"delete":{"description":"#### 🔒 OAuth Required\nUnblock a user you previously blocked.","summary":"Unblock this user","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersUnblock"}},"/users/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a user for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per reported user.\n\n| reason | description |\n|---|---|\n| `spam` | Spam account |\n| `adult` | Adult content in profile |\n| `language` | Not using English |\n| `other` | Anything else (add details in `message`) |","summary":"Report a user","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["spam","adult","language","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersReport"}},"/users/{id}/followers":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns all followers including when the relationship began.","summary":"Get followers","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"followed_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["followed_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFollowers"}},"/users/{id}/following":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns all user's they follow including when the relationship began.","summary":"Get following","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"followed_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["followed_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFollowing"}},"/users/{id}/friends":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns all friends for a user including when the relationship began. Friendship is a 2 way relationship where each user follows the other.","summary":"Get friends","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"friends_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["friends_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFriends"}},"/users/{id}/yir/{year}/persona":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional\nReturns the watching persona a user earned for a year in review, with its runner-up, traits, highlights, scores, longest streak and monthly personas. Send the `year` path parameter (2026 or later) to choose the review period.\n\nReturns `400` for an invalid year or user slug, `403` when a non-VIP user requests their own persona, and `404` when the profile is not visible or no persona has been computed.","summary":"Get year in review persona","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"year","in":"path","required":true,"schema":{"type":"integer","minimum":2026}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"persona":{"type":"string","enum":["anime-voyager","day-one-devotee","weekend-marathoner","comfort-rewatcher","omnivore","opening-night","cinephile","critic","loyalist","curator","wildcard","opening-act"]},"runner_up":{"type":"string","enum":["anime-voyager","day-one-devotee","weekend-marathoner","comfort-rewatcher","omnivore","opening-night","cinephile","critic","loyalist","curator","wildcard","opening-act"],"nullable":true},"confidence":{"type":"string","enum":["strong","leaning"]},"rarity":{"type":"integer","minimum":0,"maximum":100,"description":"How rare the persona is, as a percentage from 0 to 100."},"card_number":{"type":"integer","minimum":1,"maximum":12},"traits":{"type":"array","items":{"type":"string","enum":["streak-keeper","night-owl","early-bird","weekend-warrior","time-traveler","globetrotter","social-butterfly","automaton","app-hopper","silent-watcher","hype-machine","tough-crowd","polariser","live-checker","doc-nerd","horror-hound","fresh-start"]},"maxItems":3},"highlights":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["anime-episodes","anime-share","streak-days","premiere-share","premieres","weekend-share","binge-days","plays-per-day","catalog-share","top-show-episodes","apps","shows","networks","checkin-share","new-releases","avg-runtime","avg-vintage","pre-2000","ratings","avg-rating","perfect-tens","top-show-share","genre-share","movies","plays","personas-in-range"]},"value":{"type":"number"}},"required":["kind","value"]},"maxItems":3},"runner_up_highlights":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["anime-episodes","anime-share","streak-days","premiere-share","premieres","weekend-share","binge-days","plays-per-day","catalog-share","top-show-episodes","apps","shows","networks","checkin-share","new-releases","avg-runtime","avg-vintage","pre-2000","ratings","avg-rating","perfect-tens","top-show-share","genre-share","movies","plays","personas-in-range"]},"value":{"type":"number"}},"required":["kind","value"]},"maxItems":3},"scores":{"type":"object","properties":{"anime-voyager":{"type":"integer","minimum":0,"maximum":100},"day-one-devotee":{"type":"integer","minimum":0,"maximum":100},"weekend-marathoner":{"type":"integer","minimum":0,"maximum":100},"comfort-rewatcher":{"type":"integer","minimum":0,"maximum":100},"omnivore":{"type":"integer","minimum":0,"maximum":100},"opening-night":{"type":"integer","minimum":0,"maximum":100},"cinephile":{"type":"integer","minimum":0,"maximum":100},"critic":{"type":"integer","minimum":0,"maximum":100},"loyalist":{"type":"integer","minimum":0,"maximum":100},"curator":{"type":"integer","minimum":0,"maximum":100},"wildcard":{"type":"integer","minimum":0,"maximum":100},"opening-act":{"type":"integer","minimum":0,"maximum":100}},"required":["anime-voyager","day-one-devotee","weekend-marathoner","comfort-rewatcher","omnivore","opening-night","cinephile","critic","loyalist","curator","wildcard","opening-act"],"description":"Score from 0 to 100 for every persona."},"streak":{"type":"object","properties":{"longest":{"type":"integer"},"started_at":{"type":"string","nullable":true}},"required":["longest","started_at"]},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer","minimum":1,"maximum":12},"persona":{"type":"string","enum":["anime-voyager","day-one-devotee","weekend-marathoner","comfort-rewatcher","omnivore","opening-night","cinephile","critic","loyalist","curator","wildcard","opening-act"]}},"required":["month","persona"]}}},"required":["persona","runner_up","confidence","rarity","card_number","traits","highlights","runner_up_highlights","scores","streak","monthly"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["invalid_year","invalid_user_slug"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["vip_required"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["persona_not_found"]}},"required":["error"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersYear_in_review_persona"}},"/users/{id}/mir/{year}/{month}":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional ✨ Extended Info\nReturns a user's month in review: totals and averages, play distributions (`daily` included), first and last watched, most watched and top rated titles, genres, networks, production companies, countries and the streaming services watched on. Send the `year` and `month` path parameters to choose the month.\n\nOnly official Trakt apps can call it. The profile owner needs VIP; the viewer does not. Send `slurm` instead of an Authorization header to view as that token's owner.\n\nReturns `400` for an invalid user slug, year or month, `401` off an official app or for a private profile the viewer cannot see, `404` for an unknown user or a review that is not built yet, and `426` with an `X-Upgrade-URL` header when the profile owner is not VIP.\n\nSuccessful responses carry `X-Year`, `X-Month` and `X-Private-User` headers.","summary":"Get month in review","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"year","in":"path","required":true,"schema":{"type":"integer"}},{"name":"month","in":"path","required":true,"schema":{"type":"integer"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"slurm","in":"query","description":"A user's VIP feed token. Stands in for the viewer when the request has no Authorization header.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"first_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"last_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"most_watched":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","movie"]}}},"required":["shows","movies"]},"genres":{"type":"object","properties":{"shows":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]},"movies":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]}},"required":["shows","movies"]},"networks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"production_companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"countries":{"type":"object","properties":{"shows":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]},"movies":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]}},"required":["shows","movies"]},"top_rated":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","movie"]}}},"required":["shows","movies"]},"trends":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","movie"]}}},"required":["shows","movies"]},"thanks":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["movie"]}}},"required":["shows","movies"]},"stats":{"type":"object","properties":{"all":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"lists_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","lists_counts"]},"shows":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}},"daily":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]},"movies":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}},"daily":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]}},"required":["all","shows","movies"]},"images":{"type":"object","properties":{"cover":{"type":"string"},"story":{"type":"string"}},"required":["cover","story"]},"streaming_services":{"type":"object","properties":{"country":{"type":"string"},"services":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"name":{"type":"string"},"shows":{"type":"integer"},"movies":{"type":"integer"},"all":{"type":"integer"}},"required":["source","name","shows","movies","all"]}}},"required":["country","services"]}},"required":["first_watched","last_watched","most_watched","genres","networks","production_companies","countries","top_rated","trends","thanks","stats","images","streaming_services"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["invalid_user_slug","invalid_year","invalid_month"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["official_app_required","private_user"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["user_not_found","review_not_ready"]}},"required":["error"]}}}},"426":{"description":"426","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["vip_required"]}},"required":["error"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersMonth_in_review"}},"/users/{id}/yir/{year}":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional ✨ Extended Info\nReturns a user's year in review: totals and averages, play distributions, first and last watched, most watched and top rated titles, genres, networks, production companies and countries. Send the `year` path parameter to choose the year.\n\nOnly official Trakt apps can call it. The profile owner needs VIP; the viewer does not. Send `slurm` instead of an Authorization header to view as that token's owner.\n\nReturns `400` for an invalid user slug, year or month, `401` off an official app or for a private profile the viewer cannot see, `404` for an unknown user or a review that is not built yet, and `426` with an `X-Upgrade-URL` header when the profile owner is not VIP.\n\nSuccessful responses carry `X-Year-Start`, `X-Year-End` and `X-Private-User` headers.","summary":"Get year in review","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"year","in":"path","required":true,"schema":{"type":"integer"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"slurm","in":"query","description":"A user's VIP feed token. Stands in for the viewer when the request has no Authorization header.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"first_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"last_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"most_watched":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","movie"]}}},"required":["shows","movies"]},"genres":{"type":"object","properties":{"shows":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]},"movies":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]}},"required":["shows","movies"]},"networks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"production_companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"countries":{"type":"object","properties":{"shows":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]},"movies":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]}},"required":["shows","movies"]},"top_rated":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","movie"]}}},"required":["shows","movies"]},"trends":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","movie"]}}},"required":["shows","movies"]},"thanks":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["movie"]}}},"required":["shows","movies"]},"stats":{"type":"object","properties":{"all":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"lists_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","lists_counts"]},"shows":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]},"movies":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]}},"required":["all","shows","movies"]},"images":{"type":"object","properties":{"cover":{"type":"string"},"story":{"type":"string","nullable":true,"description":"Always null: only a month has a story image."}},"required":["cover","story"]}},"required":["first_watched","last_watched","most_watched","genres","networks","production_companies","countries","top_rated","trends","thanks","stats","images"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["invalid_user_slug","invalid_year","invalid_month"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["official_app_required","private_user"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["user_not_found","review_not_ready"]}},"required":["error"]}}}},"426":{"description":"426","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["vip_required"]}},"required":["error"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersYear_in_review"}},"/users/{id}/yir/{year}/{year_end}":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional ✨ Extended Info\nReturns a user's year in review for every year from `year` to `year_end`, both included, in the same shape as a single year.\n\nOnly official Trakt apps can call it. The profile owner needs VIP; the viewer does not. Send `slurm` instead of an Authorization header to view as that token's owner.\n\nReturns `400` for an invalid user slug, year or month, `401` off an official app or for a private profile the viewer cannot see, `404` for an unknown user or a review that is not built yet, and `426` with an `X-Upgrade-URL` header when the profile owner is not VIP.\n\nSuccessful responses carry `X-Year-Start`, `X-Year-End` and `X-Private-User` headers. `X-Year-Start` is the first year with plays inside the range.","summary":"Get year in review for a range of years","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"year","in":"path","required":true,"schema":{"type":"integer"}},{"name":"year_end","in":"path","required":true,"schema":{"type":"integer"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"slurm","in":"query","description":"A user's VIP feed token. Stands in for the viewer when the request has no Authorization header.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"first_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"last_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"most_watched":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","movie"]}}},"required":["shows","movies"]},"genres":{"type":"object","properties":{"shows":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]},"movies":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]}},"required":["shows","movies"]},"networks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"production_companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"countries":{"type":"object","properties":{"shows":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]},"movies":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]}},"required":["shows","movies"]},"top_rated":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","movie"]}}},"required":["shows","movies"]},"trends":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","movie"]}}},"required":["shows","movies"]},"thanks":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["movie"]}}},"required":["shows","movies"]},"stats":{"type":"object","properties":{"all":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"lists_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","lists_counts"]},"shows":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]},"movies":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}}},"required":["weekly","monthly","days","hourly"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions"]}},"required":["all","shows","movies"]},"images":{"type":"object","properties":{"cover":{"type":"string"},"story":{"type":"string","nullable":true,"description":"Always null: only a month has a story image."}},"required":["cover","story"]}},"required":["first_watched","last_watched","most_watched","genres","networks","production_companies","countries","top_rated","trends","thanks","stats","images"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["invalid_user_slug","invalid_year","invalid_month"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["official_app_required","private_user"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["user_not_found","review_not_ready"]}},"required":["error"]}}}},"426":{"description":"426","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["vip_required"]}},"required":["error"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersYear_in_review_range"}},"/users/{id}/yir/all":{"get":{"description":"#### 🔥 VIP Only 🔓 OAuth Optional ✨ Extended Info\nReturns a user's review of their whole history. On top of the year shape it adds plays per year, the ratings distribution, release years and decades, progress through curated top lists, and the most played titles on Trakt.\n\nOnly official Trakt apps can call it. The profile owner needs VIP; the viewer does not. Send `slurm` instead of an Authorization header to view as that token's owner.\n\nReturns `400` for an invalid user slug, year or month, `401` off an official app or for a private profile the viewer cannot see, `404` for an unknown user or a review that is not built yet, and `426` with an `X-Upgrade-URL` header when the profile owner is not VIP.\n\nSuccessful responses carry `X-Year-Start` (the first year with plays), `X-Year-End` and `X-Private-User` headers.","summary":"Get all-time year in review","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"slurm","in":"query","description":"A user's VIP feed token. Stands in for the viewer when the request has no Authorization header.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"first_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"last_watched":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","episode","show"]},{"type":"object","properties":{"watched_at":{"type":"string"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watched_at","type","movie"]}],"nullable":true},"most_watched":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"minutes":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["plays","minutes","movie"]}}},"required":["shows","movies"]},"genres":{"type":"object","properties":{"shows":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]},"movies":{"type":"object","properties":{"item_count":{"type":"integer"},"genres":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["item_count","genres"]}},"required":["shows","movies"]},"networks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"production_companies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"count":{"type":"integer"},"image_url":{"type":"string","nullable":true},"color":{"type":"string"}},"required":["id","name","count","image_url","color"]}},"countries":{"type":"object","properties":{"shows":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]},"movies":{"type":"object","properties":{"country_count":{"type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"count":{"type":"integer"}},"required":["country","count"]}}},"required":["country_count","countries"]}},"required":["shows","movies"]},"top_rated":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rating","movie"]}}},"required":["shows","movies"]},"trends":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"month":{"type":"integer"},"month_name":{"type":"string"},"watchers":{"type":"integer"},"watched":{"type":"boolean"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["month","month_name","watchers","watched","movie"]}}},"required":["shows","movies"]},"thanks":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["movie"]}}},"required":["shows","movies"]},"stats":{"type":"object","properties":{"all":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"lists_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","lists_counts"]},"shows":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}},"yearly":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"}},"required":["year","count"]}}},"required":["weekly","monthly","days","hourly","yearly"]},"ratings_distribution":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"count":{"type":"integer"}},"required":["rating","count"]}}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions","ratings_distribution"]},"movies":{"type":"object","properties":{"minutes":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"play_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"collected_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"ratings_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"comments_counts":{"type":"object","properties":{"total":{"type":"number"},"yearly":{"type":"number"},"monthly":{"type":"number"},"weekly":{"type":"number"},"daily":{"type":"number"}},"required":["total","yearly","monthly","weekly","daily"]},"items_count":{"type":"integer"},"distributions":{"type":"object","properties":{"weekly":{"type":"array","items":{"type":"integer"}},"monthly":{"type":"array","items":{"type":"integer"}},"days":{"type":"array","items":{"type":"integer"}},"hourly":{"type":"array","items":{"type":"integer"}},"yearly":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"}},"required":["year","count"]}}},"required":["weekly","monthly","days","hourly","yearly"]},"ratings_distribution":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer"},"count":{"type":"integer"}},"required":["rating","count"]}}},"required":["minutes","play_counts","collected_counts","ratings_counts","comments_counts","items_count","distributions","ratings_distribution"]}},"required":["all","shows","movies"]},"images":{"type":"object","properties":{"cover":{"type":"string"},"story":{"type":"string","nullable":true,"description":"Always null: only a month has a story image."}},"required":["cover","story"]},"release_years":{"type":"object","properties":{"shows":{"type":"object","properties":{"years":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"}},"required":["year","count"]}},"decades":{"type":"array","items":{"type":"object","properties":{"decade":{"type":"integer"},"count":{"type":"integer"}},"required":["decade","count"]}}},"required":["years","decades"]},"movies":{"type":"object","properties":{"years":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"count":{"type":"integer"}},"required":["year","count"]}},"decades":{"type":"array","items":{"type":"object","properties":{"decade":{"type":"integer"},"count":{"type":"integer"}},"required":["decade","count"]}}},"required":["years","decades"]}},"required":["shows","movies"]},"list_progress":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"site":{"type":"string"},"title":{"type":"string"},"logo":{"type":"string","nullable":true},"total":{"type":"integer"},"watched":{"type":"integer"},"percentage":{"type":"integer"}},"required":["id","site","title","logo","total","watched","percentage"]}},"movies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"site":{"type":"string"},"title":{"type":"string"},"logo":{"type":"string","nullable":true},"total":{"type":"integer"},"watched":{"type":"integer"},"percentage":{"type":"integer"}},"required":["id","site","title","logo","total","watched","percentage"]}}},"required":["shows","movies"]},"global_top":{"type":"object","properties":{"shows":{"type":"array","items":{"type":"object","properties":{"watchers":{"type":"integer"},"watched":{"type":"boolean"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watchers","watched","show"]}},"movies":{"type":"array","items":{"type":"object","properties":{"watchers":{"type":"integer"},"watched":{"type":"boolean"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watchers","watched","movie"]}}},"required":["shows","movies"]}},"required":["first_watched","last_watched","most_watched","genres","networks","production_companies","countries","top_rated","trends","thanks","stats","images","release_years","list_progress","global_top"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["invalid_user_slug","invalid_year","invalid_month"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["official_app_required","private_user"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["user_not_found","review_not_ready"]}},"required":["error"]}}}},"426":{"description":"426","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["vip_required"]}},"required":["error"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersYear_in_review_all"}},"/users/{id}/watched/movies":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns movies watched by a user in a minimal paginated format. Use `extended`, `page`, and `limit` to control the response.","summary":"Get watched movies","tags":["users","watched","minimal"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","required":true,"schema":{"type":"string","enum":["min"]}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchedMinimalMovies"}},"/users/{id}/watched/shows":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns shows watched by a user in a minimal paginated format. Use `specials` and `season_numbers` to control season details in the response.","summary":"Get watched shows","tags":["users","watched","minimal"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","required":true,"schema":{"type":"string","enum":["min"]}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"specials","in":"query","description":"Whether to include special seasons as season 0.","schema":{"type":"boolean","nullable":true}},{"name":"season_numbers","in":"query","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchedMinimalShows"}},"/users/{id}/watched/{type}":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns all movies or shows a user has watched sorted by most recently watched.","summary":"Get watched","tags":["users","watched"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Watched media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"hidden","in":"query","description":"Whether to include any hidden seasons","schema":{"type":"boolean","nullable":true}},{"name":"specials","in":"query","description":"Whether to include special seasons as season 0.","schema":{"type":"boolean","nullable":true}},{"name":"count_specials","in":"query","description":"Whether to count specials in the overall stats (only applies if specials are included).","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"last_watched_at":{"type":"string"},"last_updated_at":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]}},"required":["title","year","ids"]}},"required":["plays","last_watched_at","last_updated_at","movie"]}},{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"last_watched_at":{"type":"string"},"last_updated_at":{"type":"string"},"reset_at":{"type":"string","nullable":true},"show":{"type":"object","properties":{"aired_episodes":{"type":"integer"},"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["aired_episodes","title","ids"]},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"plays":{"type":"integer"},"last_watched_at":{"type":"string"}},"required":["number","plays","last_watched_at"]}}},"required":["number","episodes"]},"nullable":true}},"required":["plays","last_watched_at","last_updated_at","show"]}}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchedTyped"}},"/users/{id}/history/":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns watched history for a user across all supported media types. Use `start_at` and `end_at` to limit results to a UTC datetime range.","summary":"Get watched history","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","watched_at","action","type"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","watched_at","action","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryAll"}},"/users/{id}/history/movies":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns movie watched history for a user. Use `start_at` and `end_at` to limit results to a UTC datetime range.","summary":"Get movie watched history","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryMovies"}},"/users/{id}/history/shows":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns show watched history for a user. Use `start_at` and `end_at` to limit results to a UTC datetime range.","summary":"Get show watched history","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryShows"}},"/users/{id}/history/episodes":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns episode watched history for a user. Use `start_at` and `end_at` to limit results to a UTC datetime range.","summary":"Get episode watched history","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryEpisodes"}},"/users/{id}/history/movies/{item_id}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns watched history entries for one movie. Use `item_id` to identify the movie and `start_at` or `end_at` to limit the date range.","summary":"Get history for a movie","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"item_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryMovie"}},"/users/{id}/history/shows/{item_id}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns watched history entries for one show. Use `item_id` to identify the show and `start_at` or `end_at` to limit the date range.","summary":"Get history for a show","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"item_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryShow"}},"/users/{id}/history/episodes/{item_id}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns watched history entries for one episode. Use `item_id` to identify the episode and `start_at` or `end_at` to limit the date range.","summary":"Get history for an episode","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"item_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","watched_at","action","type","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryEpisode"}},"/users/{id}/history/{type}/{item_id}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info\nReturns watched history entries for one item. Use `type`, `item_id`, `start_at`, and `end_at` to limit the result set.","summary":"Get watched history","tags":["users","history"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"item_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"History media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","watched_at","action","type"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"watched_at":{"type":"string"},"action":{"type":"string","enum":["scrobble","checkin","watch"]},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","watched_at","action","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHistoryTypedItem"}},"/users/{id}/watchlist/movies/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movies on a user watchlist. Use the `sort` path parameter plus query sorting, pagination, and filters to control the result order and contents.","summary":"Get movie watchlist","tags":["users","watchlist"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"hide","in":"query","schema":{"type":"string","enum":["unwatched","collected","uncollected","rated","unrated","unreleased","noreleasedate","ended","airing","unwatchlisted","listed","notes","nonotes"],"nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchlistMovies"}},"/users/{id}/watchlist/shows/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns shows on a user watchlist. Use the `sort` path parameter plus query sorting, pagination, and filters to control the result order and contents.","summary":"Get show watchlist","tags":["users","watchlist"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"hide","in":"query","schema":{"type":"string","enum":["unwatched","collected","uncollected","rated","unrated","unreleased","noreleasedate","ended","airing","unwatchlisted","listed","notes","nonotes"],"nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchlistShows"}},"/users/{id}/watchlist/movie,show/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movies and shows on a user watchlist. Use the `sort` path parameter plus query sorting, pagination, and filters to control the result order and contents.","summary":"Get media watchlist","tags":["users","watchlist"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"hide","in":"query","schema":{"type":"string","enum":["unwatched","collected","uncollected","rated","unrated","unreleased","noreleasedate","ended","airing","unwatchlisted","listed","notes","nonotes"],"nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchlistAll"}},"/users/{id}/watchlist/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns all items in a user's watchlist filtered by type.","summary":"Get watchlist","tags":["users","watchlist"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Watchlist media type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"hide","in":"query","schema":{"type":"string","enum":["unwatched","collected","uncollected","rated","unrated","unreleased","noreleasedate","ended","airing","unwatchlisted","listed","notes","nonotes"],"nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchlistTypedSorted"}},"/users/{id}/watchlist/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for the watchlist. By default, the comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all watchlist comments","tags":["users","watchlist"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersWatchlistComments"}},"/users/{id}/ratings/movies":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns movies rated by a user including each rating value and when it was rated.","summary":"Get movie ratings","tags":["users","ratings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRatingsMovies"}},"/users/{id}/ratings/shows":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns shows rated by a user including each rating value and when it was rated.","summary":"Get show ratings","tags":["users","ratings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRatingsShows"}},"/users/{id}/ratings/episodes":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns episodes rated by a user including each rating value and when it was rated.","summary":"Get episode ratings","tags":["users","ratings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRatingsEpisodes"}},"/users/{id}/ratings/":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info\nReturns all ratings by a user including each rating value and when it was rated.","summary":"Get all ratings","tags":["users","ratings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRatingsAll"}},"/users/{id}/ratings/{type}/{rating}":{"get":{"description":"Returns ratings by a user for the requested media type and rating value.","summary":"Get ratings","tags":["users","ratings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Rated media type filter."},{"name":"rating","in":"path","required":true,"schema":{"type":"string"},"description":"Rating filter from 1 to 10."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]},{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":10},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rated_at","rating","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRatingsTypedRating"}},"/users/{id}/favorites/media/{sort}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns favorite movies and shows for a user. Use the `sort` path parameter plus query sorting and pagination to control the result order.","summary":"Get favorite media","tags":["users","favorites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","show"]},{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","movie"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFavoritesMedia"}},"/users/{id}/favorites/movies/{sort}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns favorite movies for a user. Use the `sort` path parameter plus query sorting and pagination to control the result order.","summary":"Get favorite movies","tags":["users","favorites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFavoritesMovies"}},"/users/{id}/favorites/shows/{sort}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns favorite shows for a user. Use the `sort` path parameter plus query sorting and pagination to control the result order.","summary":"Get favorite shows","tags":["users","favorites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFavoritesShows"}},"/users/{id}/favorites/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info 😁 Emojis\nReturns the top 100 shows and movies a user has favorited.","summary":"Get favorites","tags":["users","favorites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Favorites media type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","show"]},{"type":"object","properties":{"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"rank":{"type":"integer"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["id","listed_at","rank","type","movie"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFavoritesTypedSorted"}},"/users/{id}/favorites/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for the favorites. By default, the comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all favorites comments","tags":["users","favorites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFavoritesComments"}},"/users/{id}/lists":{"get":{"description":"#### 🔓 OAuth Optional 😁 Emojis\nReturns all personal lists for a user. Use the [**/users/:id/lists/:list_id/items**](#reference/users/list-items) method to get the actual items a specific list contains.","summary":"Get a user's personal lists","tags":["users","lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsPersonal"},"post":{"description":"#### 🔥 VIP Enhanced 🔒 OAuth Required\nCreate a new personal list. The `name` is the only required field, but the other info is recommended to ask for.\n\n#### Limits\n\nIf the user's list limit is exceeded, a `420` HTTP error code is returned. Use the [**/users/settings**](/reference/users/settings) method to get all limits for a user account. In most cases, upgrading to [**Trakt VIP**](https://app.trakt.tv/vip) will increase the limits.\n\n#### Privacy\n\nLists will be `private` by default. Here is what each value means.\n\n| Value | Privacy impact... |\n|---|---|\n| `private` | Only you can see the list. |\n| `link` | Anyone with the `share_link` can see the list. |\n| `friends` | Only your friends can see the list. |\n| `public` | Anyone can see the list. |\n\n#### JSON POST Data\n| Key | Type | Default | Value |\n|---|---|---|---|\n| `name` * | string | | Name of the list. |\n| `description` | string | | Description for this list. |\n| `privacy` | string | `private` | `private`, `link`, `friends`, `public` |\n| `display_numbers` | boolean | `false` | Should each item be numbered? |\n| `allow_comments` | boolean | `true` | Are comments allowed? |\n| `sort_by` | string | `rank` | `rank`, `added`, `title`, `released`, `runtime`, `popularity`, `random`, `percentage`, `imdb_rating`, `tmdb_rating`, `rt_tomatometer`, `rt_audience`, `metascore`, `votes`, `imdb_votes`, `tmdb_votes`, `my_rating`, `watched`, `collected` |\n| `sort_how` | string | `asc` | `asc`, `desc` |","summary":"Create personal list","tags":["users","lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"privacy":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]}},"required":["name"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsCreate"}},"/users/{id}/lists/collaborations":{"get":{"description":"#### 🔓 OAuth Optional\nReturns all lists a user can collaborate on. This gives full access to add, remove, and re-order list items. It essentially works just like a list owned by the user, just make sure to use the correct list owner `user` when building the API URLs.","summary":"Get all lists a user can collaborate on","tags":["users","lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsCollaborations"}},"/users/{id}/lists/reorder":{"post":{"description":"#### 🔒 OAuth Required\nReorder all lists by sending the updated `rank` of list ids. Use the [**/users/:id/lists**](#reference/users/lists) method to get all list ids.","summary":"Reorder a user's lists","tags":["users","lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"type":"array","items":{"type":"integer"}}},"required":["rank"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"skipped_ids":{"type":"array","items":{"type":"integer"}}},"required":["updated","skipped_ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsReorder"}},"/users/{id}/lists/{list_id}/":{"get":{"description":"#### 🔓 OAuth Optional 😁 Emojis\nReturns a single personal list. Use the [**/users/:id/lists/:list_id/items**](#reference/users/list-items) method to get the actual items this list contains.","summary":"Get personal list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListSummary"},"put":{"description":"#### 🔒 OAuth Required\nUpdate a personal list by sending 1 or more parameters. If you update the list name, the original slug will still be retained so existing references to this list won't break.\n\n#### Privacy\n\nLists will be `private` by default. Here is what each value means.\n\n| Value | Privacy impact... |\n|---|---|\n| `private` | Only you can see the list. |\n| `link` | Anyone with the `share_link` can see the list. |\n| `friends` | Only your friends can see the list. |\n| `public` | Anyone can see the list. |\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|---|\n| `name` | string | Name of the list. |\n| `description` | string | Description for this list. |\n| `privacy` | string | `private`, `link`, `friends`, `public` |\n| `display_numbers` | boolean | Should each item be numbered? |\n| `allow_comments` | boolean | Are comments allowed? |\n| `sort_by` | string | `rank`, `added`, `title`, `released`, `runtime`, `popularity`, `random`, `percentage`, `imdb_rating`, `tmdb_rating`, `rt_tomatometer`, `rt_audience`, `metascore`, `votes`, `imdb_votes`, `tmdb_votes`, `my_rating`, `watched`, `collected` |\n| `sort_how` | string | `asc`, `desc` |","summary":"Update personal list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"privacy":{"type":"string","nullable":true},"display_numbers":{"type":"boolean","nullable":true},"allow_comments":{"type":"boolean","nullable":true},"sort_by":{"type":"string","nullable":true,"description":"The field to sort by"},"sort_how":{"type":"string","enum":["asc","desc"],"nullable":true,"description":"The direction to sort in"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersListsListUpdate"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a personal list and all items it contains.","summary":"Delete a user's personal list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"403":{"description":"403","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersListsListDelete"}},"/users/{id}/lists/{list_id}/items/movie":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movie items on a personal list. Use `list_id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get movie list items","tags":["users","lists","list","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListItemsMovie"}},"/users/{id}/lists/{list_id}/items/show":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns show items on a personal list. Use `list_id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get show list items","tags":["users","lists","list","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListItemsShow"}},"/users/{id}/lists/{list_id}/items/movie,show":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movie and show items on a personal list. Use `list_id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get media list items","tags":["users","lists","list","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListItemsMedia"}},"/users/{id}/lists/{list_id}/items/movie,show,season,episode":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movie, show, season, and episode items on a personal list. Use `list_id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get all list items","tags":["users","lists","list","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListItemsAll"}},"/users/{id}/lists/{list_id}/items/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns items on a personal list. Use `type`, `sort_by`, and `sort_how` to control the returned item set and order.","summary":"Get items on a personal list","tags":["users","lists","list","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"List item type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListItemsTypedSorted"}},"/users/{id}/lists/{list_id}/items":{"post":{"description":"#### 🔥 VIP Enhanced 🔒 OAuth Required 😁 Emojis\nAdd one or more items to a personal list. Items can be movies, shows, seasons, or episodes.\n\n#### Notes\n\nEach list item can optionally accept a `notes` *(500 maximum characters)* field with custom text. The user must be a [**Trakt VIP**](https://app.trakt.tv/vip) to send `notes`.\n\n#### Limits\n\nIf the user's list item limit is exceeded, a `420` HTTP error code is returned. Use the [**/users/settings**](/reference/users/settings) method to get all limits for a user account. In most cases, upgrading to [**Trakt VIP**](https://app.trakt.tv/vip) will increase the limits.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |","summary":"Add items to personal list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"existing":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["added","existing","not_found","list"]}}}},"420":{"description":"420","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListAdd"}},"/users/{id}/lists/{list_id}/items/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove one or more items from a personal list.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |","summary":"Remove items from personal list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["deleted","not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListRemove"}},"/users/{id}/lists/{list_id}/reorder":{"post":{"description":"#### 🔒 OAuth Required\nReorder items on a personal list. Send the ordered list item IDs in the request body; the response returns the updated item order.","summary":"Reorder items on a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"type":"array","items":{"type":"integer"}}},"required":["rank"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"skipped_ids":{"type":"array","items":{"type":"integer"}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["updated","skipped_ids","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListReorder"}},"/users/{id}/lists/{list_id}/items/reorder":{"post":{"description":"#### 🔒 OAuth Required\nReorder items on a personal list. Send the ordered list item IDs in the request body; the response returns the updated item order.","summary":"Reorder items on a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"type":"array","items":{"type":"integer"}}},"required":["rank"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"skipped_ids":{"type":"array","items":{"type":"integer"}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["updated","skipped_ids","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListReorderItems"}},"/users/{id}/lists/{list_id}/items/{list_item_id}":{"put":{"description":"Update a single personal list item by list item ID. A successful update returns no response body.","summary":"Update a list item","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"list_item_id","in":"path","required":true,"schema":{"type":"string"},"description":"List item ID."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"notes":{"type":"string","nullable":true},"rank":{"type":"integer"}},"additionalProperties":true}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersListsListUpdateItem"}},"/users/{id}/lists/{list_id}/likes":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination\nReturns all users who liked a list.","summary":"Get all users who liked a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"liked_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["liked_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListLikes"}},"/users/{id}/lists/{list_id}/like":{"post":{"description":"#### 🔒 OAuth Required\nVotes help determine popular lists. Only one like is allowed per list per user.","summary":"Like a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListLike"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a like on a list.","summary":"Remove like on a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersListsListUnlike"}},"/users/{id}/lists/{list_id}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for a list. By default, the comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all list comments","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies"],"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListComments"}},"/users/{id}/lists/{list_id}/smart-list-draft":{"get":{"description":"#### 🔒 OAuth Required\nReturns a ready-made smart list setup for a personal list that stopped updating (see `stale_origin` on the list). Only the list owner can read it.\n\n`filters` use the same shape as smart list filters, so they can be sent as-is when creating a smart list. `confidence` is the share of the list's current titles the setup brings back, from 0 to 1. Lists without a good setup return `404`. `converted` is set once the owner has turned the list into a smart list.","summary":"Get a smart list draft for a list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"]},"origin_url":{"type":"string","nullable":true},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}},"unsupported":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"converted":{"type":"object","properties":{"smart_list_id":{"type":"integer"},"converted_at":{"type":"string"}},"required":["smart_list_id","converted_at"],"nullable":true}},"required":["list","origin_url","source","media_type","filters","unsupported","confidence","converted"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersListsListSmartListDraft"}},"/users/{id}/lists/{list_id}/smart-list-draft/convert":{"post":{"description":"#### 🔒 OAuth Required\nTurns your personal list that stopped updating (see `stale_origin`) into a smart list. Send the same body as creating a smart list, usually the `filters`, `source` and `media_type` from [**smart-list-draft**](#reference/users/lists), edited as you like. Only the list owner can convert it.\n\nThe list keeps its address: its items are then served from the smart list, and it carries `converted_to` pointing at the smart list. Filters sent with its items request narrow the smart list, the same way they narrow a regular list.\n\n| Status | When |\n|---|---|\n| `201` | Converted; `ids` of the new smart list. |\n| `200` | Already converted; `ids` of the existing smart list. Safe to retry. |\n| `404` | `list_not_convertible` |\n| `420` | Smart list limit reached. |","summary":"Turn a list into a smart list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"source":{"type":"string","enum":["trending","popular","anticipated","recommendations","discover","watchlist","library"]},"media_type":{"type":"string","enum":["movies","shows","media"]},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}},"privacy":{"type":"string","enum":["public","private","friends"]}},"required":["name","source","media_type"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"]}}}},"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"420":{"description":"420","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListConvertToSmartList"}},"/users/{id}/lists/{list_id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a list for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per list.","summary":"Report a user's list","tags":["users","lists","list"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","metadata","adult","language","spam","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersListsListReport"}},"/users/{id}/smart-lists":{"get":{"description":"#### 🔓 OAuth Optional\nReturns all smart list definitions for a user. Use the [**/smart-lists/:list_id/items**](#reference/smart-lists) method to get the dynamic items a specific smart list resolves to.","summary":"Get a user's smart lists","tags":["users","smartLists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"privacy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"]},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}}},"required":["name","privacy","created_at","updated_at","ids","images","source","media_type","filters"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSmartListsPersonal"},"post":{"description":"#### 🔥 VIP Enhanced 🔒 OAuth Required\nCreate a new smart list. A smart list is a dynamic list driven by a `source` and `filters` rather than manually added items.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `name` * | string | Name of the smart list. |\n| `source` * | string | `trending`, `popular`, `anticipated`, `recommendations`, `discover`, `watchlist`, `library` |\n| `media_type` * | string | `movies`, `shows`, `media` |\n| `filters` | object | Filter constraints applied to the source. |\n| `privacy` | string | `public`, `private`, `friends` |","summary":"Create smart list","tags":["users","smartLists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"source":{"type":"string","enum":["trending","popular","anticipated","recommendations","discover","watchlist","library"]},"media_type":{"type":"string","enum":["movies","shows","media"]},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}},"privacy":{"type":"string","enum":["public","private","friends"]}},"required":["name","source","media_type"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersSmartListsCreate"}},"/users/{id}/smart-lists/{list_id}/":{"get":{"description":"#### 🔓 OAuth Optional\nReturns a single smart list definition. Use the [**/smart-lists/:list_id/items**](#reference/smart-lists) method to get the dynamic items this smart list resolves to.","summary":"Get smart list","tags":["users","smartLists","smartList"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"privacy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"]},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}}},"required":["name","privacy","created_at","updated_at","ids","images","source","media_type","filters"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSmartListsSmartListSummary"},"put":{"description":"#### 🔒 OAuth Required\nUpdate a smart list by sending 1 or more parameters. The `source`, `media_type`, `filters`, and `privacy` can all be changed; the slug is retained so existing references keep working.","summary":"Update smart list","tags":["users","smartLists","smartList"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"source":{"type":"string","enum":["trending","popular","anticipated","recommendations","discover","watchlist","library"]},"media_type":{"type":"string","enum":["movies","shows","media"]},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}},"privacy":{"type":"string","enum":["public","private","friends"]}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"privacy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"]},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}}},"required":["name","privacy","created_at","updated_at","ids","images","source","media_type","filters"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putUsersSmartListsSmartListUpdate"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a smart list.","summary":"Delete a user's smart list","tags":["users","smartLists","smartList"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."},{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersSmartListsSmartListDelete"}},"/users/{id}/smart-list-drafts":{"get":{"description":"#### 🔒 OAuth Required\nReturns how many of your personal lists that stopped updating (see `stale_origin` on a list) have a ready-made smart list setup, the best setup's `confidence`, and the top three of those lists. Only the owner can read it.\n\nLists are counted when their setup's `confidence` is 0.5 or more and they haven't been converted yet. With none, it returns `convertible_count: 0` and `best_confidence: null`.","summary":"Get lists ready to become smart lists","tags":["users","smartListDrafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The slug that identifies the user, or \"me\" for the authenticated user."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"convertible_count":{"type":"integer"},"best_confidence":{"type":"number","nullable":true},"lists":{"type":"array","items":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"name":{"type":"string","nullable":true},"item_count":{"type":"integer","nullable":true},"confidence":{"type":"number"}},"required":["ids","name","item_count","confidence"]}}},"required":["convertible_count","best_confidence","lists"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersSmartListDraftsSummary"}},"/users/hidden/{section}":{"post":{"description":"#### 🔒 OAuth Required\nHide items for a specific section. Here's what type of items can hidden for each section. You can optionally specify the `hidden_at` date for each item.\n\n#### Hideable Media Objects\n| Section | Objects |\n|---|---|---|\n| `calendar` | `movie`, `show` |\n| `progress_watched` | `show`, `season` |\n| `progress_collected` | `show`, `season` |\n| `recommendations` | `movie`, `show` |\n| `comments` | `user` |\n| `dropped` | `show` |\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `users` | array | Array of `user` objects. |","summary":"Add hidden items","tags":["users","hidden"],"parameters":[{"name":"section","in":"path","required":true,"schema":{"type":"string","enum":["calendar","progress_watched","progress_collected","recommendations","comments","dropped"]}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"season":{"type":"integer"}},"required":["movies","shows","season"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["added","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersHiddenAdd"},"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns hidden items for a specific section. Use `type`, `page`, and `limit` to filter and paginate the hidden items.","summary":"Get hidden items","tags":["users","hidden"],"parameters":[{"name":"section","in":"path","required":true,"schema":{"type":"string","enum":["calendar","progress_watched","progress_collected","recommendations","comments","dropped"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"type","in":"query","description":"Hidden item type filter.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"hidden_at":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHiddenGetBySection"}},"/users/hidden/progress_watched":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns shows hidden from watched progress for the authenticated user. Use `type`, `page`, and `limit` to filter and paginate the hidden items.","summary":"Get hidden progress items","tags":["users","hidden"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["show"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"hidden_at":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHiddenGet"}},"/users/hidden/dropped":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns shows the authenticated user has dropped or hidden from progress. Use pagination to move through the hidden dropped list.","summary":"Get dropped shows","tags":["users","hidden"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"hidden_at":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersHiddenDropped"}},"/users/hidden/progress_watched/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove shows or seasons from hidden watched progress. Send hideable media objects in the request body; the response contains remove counts.","summary":"Remove hidden progress items","tags":["users","hidden","remove"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersHiddenRemoveProgress"}},"/users/hidden/calendar/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove movies or shows from hidden calendar items. Send hideable media objects in the request body; the response contains remove counts.","summary":"Remove hidden calendar items","tags":["users","hidden","remove"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersHiddenRemoveCalendar"}},"/users/hidden/{section}/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove hidden items for a specific section. Send hideable media objects in the request body; the response contains remove counts.","summary":"Remove hidden items","tags":["users","hidden","remove"],"parameters":[{"name":"section","in":"path","required":true,"schema":{"type":"string","enum":["calendar","progress_watched","progress_collected","recommendations","comments","dropped"]}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersHiddenRemoveSection"}},"/users/requests/":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nList a user's pending follow requests so they can either approve or deny them.","summary":"Get follow requests","tags":["users","requests"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"requested_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","requested_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRequestsFollow"}},"/users/requests/following":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nList a user's pending following requests that they're waiting for the other user's to approve.","summary":"Get pending following requests","tags":["users","requests"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"requested_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","requested_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersRequestsFollowing"}},"/users/requests/{id}":{"post":{"description":"#### 🔒 OAuth Required\nApprove a follower using the `id` of the request. If the `id` is not found, was already approved, or was already denied, a `404` error will be returned.","summary":"Approve follow request","tags":["users","requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"followed_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["followed_at","user"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postUsersRequestsApprove"},"delete":{"description":"#### 🔒 OAuth Required\nDeny a follower using the `id` of the request. If the `id` is not found, was already approved, or was already denied, a `404` error will be returned.","summary":"Deny follow request","tags":["users","requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteUsersRequestsDeny"}},"/users/saved_filters/{section}":{"get":{"description":"#### 🔥 VIP Only 🔒 OAuth Required 📄 Pagination\nGet all saved filters a user has created. The `path` and `query` can be used to construct an API path to retrieve the saved data. Think of this like a dynamically updated list.","summary":"Get saved filters","tags":["users","filters"],"parameters":[{"name":"section","in":"path","required":true,"schema":{"type":"string","enum":["movies","shows","calendars","search"]}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"query":{"type":"string"},"updated_at":{"type":"string"},"section":{"type":"string","enum":["movies","shows","calendars","search"]}},"required":["rank","id","name","path","query","updated_at","section"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getUsersFiltersSaved"}},"/sync/last_activities":{"get":{"description":"#### 🔒 OAuth Required\nReturns the latest activity timestamps for the authenticated user. Cache these dates locally and compare them before syncing to avoid fetching data that has not changed.","summary":"Get last activity","tags":["sync"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"all":{"type":"string"},"movies":{"type":"object","properties":{"watched_at":{"type":"string"},"collected_at":{"type":"string"},"rated_at":{"type":"string"},"watchlisted_at":{"type":"string"},"favorited_at":{"type":"string"},"commented_at":{"type":"string"},"paused_at":{"type":"string"},"hidden_at":{"type":"string"}},"required":["watched_at","collected_at","rated_at","watchlisted_at","favorited_at","commented_at","paused_at","hidden_at"]},"episodes":{"type":"object","properties":{"watched_at":{"type":"string"},"collected_at":{"type":"string"},"rated_at":{"type":"string"},"watchlisted_at":{"type":"string"},"commented_at":{"type":"string"},"paused_at":{"type":"string"}},"required":["watched_at","collected_at","rated_at","watchlisted_at","commented_at","paused_at"]},"shows":{"type":"object","properties":{"rated_at":{"type":"string"},"watchlisted_at":{"type":"string"},"favorited_at":{"type":"string"},"commented_at":{"type":"string"},"hidden_at":{"type":"string"},"dropped_at":{"type":"string"}},"required":["rated_at","watchlisted_at","favorited_at","commented_at","hidden_at","dropped_at"]},"seasons":{"type":"object","properties":{"rated_at":{"type":"string"},"watchlisted_at":{"type":"string"},"commented_at":{"type":"string"},"hidden_at":{"type":"string"}},"required":["rated_at","watchlisted_at","commented_at","hidden_at"]},"comments":{"type":"object","properties":{"liked_at":{"type":"string"},"reacted_at":{"type":"string"},"blocked_at":{"type":"string"}},"required":["liked_at","reacted_at","blocked_at"]},"lists":{"type":"object","properties":{"liked_at":{"type":"string"},"reacted_at":{"type":"string"},"updated_at":{"type":"string"},"commented_at":{"type":"string"}},"required":["liked_at","reacted_at","updated_at","commented_at"]},"watchlist":{"type":"object","properties":{"updated_at":{"type":"string"}},"required":["updated_at"]},"favorites":{"type":"object","properties":{"updated_at":{"type":"string"}},"required":["updated_at"]},"collaborations":{"type":"object","properties":{"updated_at":{"type":"string"}},"required":["updated_at"]},"account":{"type":"object","properties":{"settings_at":{"type":"string"},"followed_at":{"type":"string"},"following_at":{"type":"string"},"pending_at":{"type":"string"},"requested_at":{"type":"string"}},"required":["settings_at","followed_at","following_at","pending_at","requested_at"]},"saved_filters":{"type":"object","properties":{"updated_at":{"type":"string"}},"required":["updated_at"]},"notes":{"type":"object","properties":{"updated_at":{"type":"string"}},"required":["updated_at"]}},"required":["all","movies","episodes","shows","seasons","comments","lists","watchlist","favorites","collaborations","account","saved_filters","notes"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncLastActivities"}},"/sync/history/{type}/{id}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns movies and episodes that a user has watched, sorted by most recent. Specify a `type` and Trakt `id` to limit the history for just that item.","summary":"Get watched history","tags":["sync","history"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Trakt ID for a specific item."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"watched_at":{"type":"string"},"action":{"type":"string"},"type":{"type":"string"}},"required":["id","watched_at","action","type"],"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncHistoryGet"}},"/sync/history":{"post":{"description":"#### 🔒 OAuth Required\nAdd items to a user's watch history. Accepts shows, seasons, episodes and movies. If only a show is passed, all episodes for the show will be added. If seasons are specified, only episodes in those seasons will be added.\n\nSend a `watched_at` UTC datetime to mark items as watched in the past. This is useful for syncing past watches from a media center.\n\n> ### IMPORTANT\n> _Please be careful with sending duplicate data. We don't verify the `item` + `watched_at` to ensure it's unique, it is up to your app to veify this and not send duplicate plays._\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |\n\n#### Media Object POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie`, `show`, or `episode` object. |\n| `watched_at` | datetime | UTC datetime when the item was watched. Set to `released` to automatically use the initial release date + runtime *(episodes only)*. Set to `unknown` to mark the item as watched without a specific date. |","summary":"Add items to watched history","tags":["sync","history"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"updated":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["added","updated","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncHistoryAdd"}},"/sync/history/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove items from a user's watch history including all watches, scrobbles, and checkins. Accepts shows, seasons, episodes and movies. If only a show is passed, all episodes for the show will be removed. If seasons are specified, only episodes in those seasons will be removed.\n\nYou can also send a list of raw history `ids` _(64-bit integers)_ to delete single plays from the watched history. The [**/sync/history**](#reference/sync/get-history) method will return an individual `id` _(64-bit integer)_ for each history item.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |\n| `ids` | array | Array of history ids. |","summary":"Remove items from history","tags":["sync","history"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"ids":{"type":"array","items":{"type":"number","format":"int64"},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["number"]},"nullable":true},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"watched_at":{"type":"string","nullable":true,"description":"When the item was watched: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time."}},"required":["ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncHistoryRemove"}},"/sync/progress/up_next":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns the authenticated user up next progress ordered by the requested sort. Use `include_stats` and `lifetime_stats` to include additional watch stats.","summary":"Get up next","tags":["sync","progress","upNext"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"include_stats","in":"query","description":"Whether to include stats in the response","schema":{"type":"boolean","nullable":true}},{"name":"lifetime_stats","in":"query","description":"When true, `progress.completed` and `progress.stats` reflect lifetime totals across all watches of the show. When false (default), they reflect the current watching session — i.e. counters reset by `/shows/:id/progress/watched/reset`.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"progress":{"type":"object","properties":{"aired":{"type":"integer"},"completed":{"type":"integer"},"last_watched_at":{"type":"string","nullable":true},"reset_at":{"type":"string","format":"null","nullable":true},"next_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"last_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true}},"required":["aired","completed","reset_at","next_episode","last_episode"]}},"required":["show","progress"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressUpNextStandard"}},"/sync/progress/up_next_nitro":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination\nReturns the authenticated user up next progress optimized for intent-based clients. Use `intent` plus sorting and pagination to control the response.","summary":"Get up next nitro","tags":["sync","progress","upNext"],"parameters":[{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"intent","in":"query","description":"To get shows a user is just starting, continuing, completed, or all shows.","schema":{"type":"string","enum":["all","continue","start","completed"]}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"progress":{"type":"object","properties":{"aired":{"type":"integer"},"completed":{"type":"integer"},"last_watched_at":{"type":"string","nullable":true},"reset_at":{"type":"string","format":"null","nullable":true},"next_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"last_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true}},"required":["aired","completed","reset_at","next_episode","last_episode"]}},"required":["show","progress"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressUpNextNitro"}},"/sync/playback/movies":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info\nReturns in-progress movie playback items for the authenticated user, most recently paused first. Use `start_at` and `end_at` to filter on `paused_at` within a UTC datetime range.\n\nPagination is opt-in: without `page` or `limit` the whole set is returned and no `X-Pagination-*` headers are sent. Sending either paginates and adds the headers.","summary":"Get movie playback progress","tags":["sync","progress"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"progress":{"type":"number","minimum":0,"maximum":100,"format":"float"},"paused_at":{"type":"string"},"id":{"type":"number","format":"int64"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["progress","paused_at","id","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressMovies"}},"/sync/playback/episodes":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info\nReturns in-progress episode playback items for the authenticated user, most recently paused first. Each item carries the parent `show`. Use `start_at` and `end_at` to filter on `paused_at` within a UTC datetime range.\n\nPagination is opt-in: without `page` or `limit` the whole set is returned and no `X-Pagination-*` headers are sent. Sending either paginates and adds the headers.","summary":"Get episode playback progress","tags":["sync","progress"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"progress":{"type":"number","minimum":0,"maximum":100,"format":"float"},"paused_at":{"type":"string"},"id":{"type":"number","format":"int64"},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["progress","paused_at","id","type","episode","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressEpisodes"}},"/sync/playback":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info\nReturns in-progress movie and episode playback items for the authenticated user, most recently paused first. Use `start_at` and `end_at` to filter on `paused_at` within a UTC datetime range.\n\nDiscriminate on `type`: movie items carry `movie`, episode items carry `episode` and the parent `show`.\n\nPagination is opt-in: without `page` or `limit` the whole set is returned and no `X-Pagination-*` headers are sent. Sending either paginates and adds the headers.","summary":"Get playback progress","tags":["sync","progress"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"start_at","in":"query","description":"Start date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}},{"name":"end_at","in":"query","description":"End date for the range. Must be formatted as \"YYYY-MM-DD\".","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"progress":{"type":"number","minimum":0,"maximum":100,"format":"float"},"paused_at":{"type":"string"},"id":{"type":"number","format":"int64"},"type":{"type":"string","enum":["movie","episode"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["progress","paused_at","id","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressPlayback"}},"/sync/playback/{id}":{"delete":{"description":"#### 🔒 OAuth Required\nRemove a playback item from a user's playback progress list. A `404` will be returned if the `id` is invalid.","summary":"Remove a playback item","tags":["sync","progress","drop"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"ID of the playback entry"}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteSyncProgressDropMovie"}},"/sync/progress/watched":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns watched progress for the authenticated user. Use hide filters to include or exclude completed, incomplete, or currently rewatching shows.","summary":"Get watched progress","tags":["sync","progress"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"lifetime_stats","in":"query","description":"When true, `progress.completed` and `progress.stats` reflect lifetime totals across all watches of the show. When false (default), they reflect the current watching session — i.e. counters reset by `/shows/:id/progress/watched/reset`.","schema":{"type":"boolean"}},{"name":"hide_completed","in":"query","schema":{"type":"boolean"}},{"name":"hide_not_completed","in":"query","schema":{"type":"boolean"}},{"name":"only_rewatching","in":"query","description":"When true, restrict the list to shows the user is currently rewatching (i.e. those with an active `progress.reset_at`).","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"progress":{"type":"object","properties":{"aired":{"type":"integer"},"completed":{"type":"integer"},"last_watched_at":{"type":"string","nullable":true},"reset_at":{"type":"string","format":"null","nullable":true},"next_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"last_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true}},"required":["aired","completed","reset_at","next_episode","last_episode"]}},"required":["show","progress"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncProgressWatched"}},"/sync/watched/{type}":{"get":{"description":"Returns all movies, shows, seasons, or episodes watched by the authenticated user.","summary":"Get watched","tags":["sync"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"plays":{"type":"integer"},"last_watched_at":{"type":"string"},"type":{"type":"string"}},"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncWatched"}},"/sync/watchlist/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info 😁 Emojis\nReturns all items in the authenticated user's watchlist filtered by type.","summary":"Get watchlist","tags":["sync","watchlist"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"type":{"type":"string"}},"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncWatchlistGet"}},"/sync/watchlist":{"put":{"description":"Update watchlist item metadata such as notes or rank for multiple items.","summary":"Update watchlist","tags":["sync","watchlist"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"existing":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["added","existing","not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"putSyncWatchlistUpdate"},"post":{"description":"#### 🔥 VIP Enhanced 🔒 OAuth Required 😁 Emojis\nAdd one of more items to a user's watchlist. Accepts shows, seasons, episodes and movies. If only a show is passed, only the show itself will be added. If seasons are specified, all of those seasons will be added.\n\n#### Notes\n\nEach watchlist item can optionally accept a `notes` *(500 maximum characters)* field with custom text. The user must be a [**Trakt VIP**](https://app.trakt.tv/vip) to send `notes`.\n\n#### Limits\n\nIf the user's watchlist limit is exceeded, a `420` HTTP error code is returned. Use the [**/users/settings**](/reference/users/settings) method to get all limits for a user account. In most cases, upgrading to [**Trakt VIP**](https://app.trakt.tv/vip) will increase the limits.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |","summary":"Add items to watchlist","tags":["sync","watchlist"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"existing":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["added","existing","not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncWatchlistAdd"}},"/sync/watchlist/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove one or more items from a user's watchlist.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |","summary":"Remove items from watchlist","tags":["sync","watchlist"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["number"]},"nullable":true},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"notes":{"type":"string","nullable":true,"description":"Custom text for the list item, cut to 500 characters. Ignored unless the list owner is a Trakt VIP."}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["deleted","not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncWatchlistRemove"}},"/sync/watchlist/reorder":{"post":{"description":"Reorder all items in a user watchlist by sending the ordered list item IDs.","summary":"Reorder watchlist items","tags":["sync","watchlist"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"type":"array","items":{"type":"integer"}}},"required":["rank"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"skipped_ids":{"type":"array","items":{"type":"integer"}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["updated","skipped_ids","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncWatchlistReorder"}},"/sync/watchlist/{list_item_id}":{"put":{"description":"Update a single watchlist item by list item ID. A successful update returns no response body.","summary":"Update a watchlist item","tags":["sync","watchlist"],"parameters":[{"name":"list_item_id","in":"path","required":true,"schema":{"type":"string"},"description":"List item ID."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"notes":{"type":"string","nullable":true},"rank":{"type":"integer"}},"additionalProperties":true}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"putSyncWatchlistUpdateItem"}},"/sync/ratings/{type}/{rating}":{"get":{"description":"Returns all ratings for the requested media type and rating value.","summary":"Get ratings","tags":["sync","ratings"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"rating","in":"path","required":true,"schema":{"type":"string"},"description":"Rating filter from 1 to 10."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rated_at":{"type":"string"},"rating":{"type":"integer"},"type":{"type":"string"}},"required":["rated_at","rating","type"],"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncRatingsGet"}},"/sync/ratings":{"post":{"description":"#### 🔒 OAuth Required\nRate one or more items. Accepts shows, seasons, episodes and movies. A show without `seasons` rates the show itself. Send `seasons` inside a show to rate those seasons instead; add `episodes` to a season to rate only those episodes. Items without a `rating` are skipped.\n\nSend a `rated_at` UTC datetime to mark items as rated in the past. This is useful for syncing ratings from a media center.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |\n\n#### Media Object POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie`, `show`, `season`, or `episode` object. |\n| `rating` * | integer | Between 1 and 10. |\n| `rated_at` | datetime | UTC datetime when the item was rated. |","summary":"Add new ratings","tags":["sync","ratings"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["rating","ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"}},"required":["rating","number"]},"nullable":true}},"required":["number"]},"nullable":true}},"required":["ids"]},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["rating","ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["rating","ids"]},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["rating","ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"}},"required":["rating","number"]},"nullable":true}},"required":["number"]},"nullable":true}},"required":["ids"]},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"}},"required":["rating","number"]},"nullable":true}},"required":["number"]},"nullable":true}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"}},"required":["rating","number"]},"nullable":true}},"required":["number"]},"nullable":true}},"required":["ids"]},"nullable":true}}}},"required":["added","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncRatingsAdd"}},"/sync/ratings/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove ratings for one or more items.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |","summary":"Remove ratings","tags":["sync","ratings"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"},"seasons":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","shows","seasons","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["rating","ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10,"nullable":true},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"number":{"type":"integer"}},"required":["rating","number"]},"nullable":true}},"required":["number"]},"nullable":true}},"required":["ids"]},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["rating","ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","minimum":1,"maximum":10},"rated_at":{"type":"string","nullable":true},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["rating","ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncRatingsRemove"}},"/sync/favorites/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination Optional ✨ Extended Info 😁 Emojis\nReturns all items in the authenticated user's favorites filtered by type.","summary":"Get favorites","tags":["sync","favorites"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"type":{"type":"string"}},"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncFavoritesGet"}},"/sync/favorites":{"post":{"description":"#### 🔒 OAuth Required 😁 Emojis\nIf the user only had 50 TV shows and movies to bring with them on a deserted island, what would they be? Apps should encourage user's to add favorites so the algorithm keeps getting better.\n\n#### Notes\n\nEach favorite can optionally accept a `notes` *(500 maximum characters)* field explaining why the user favorited the item.\n\n#### Limits\n\nIf the user's favorite limit is exceeded, a `420` HTTP error code is returned. This limit applies to all users.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |","summary":"Add items to favorites","tags":["sync","favorites"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"}},"required":["movies","shows"],"nullable":true},"existing":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"}},"required":["movies","shows"],"nullable":true},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncFavoritesAdd"}},"/sync/favorites/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove items from a user's favorites. Apps should encourage user's to add favorites so the algorithm keeps getting better.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |","summary":"Remove items from favorites","tags":["sync","favorites"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"shows":{"type":"integer"}},"required":["movies","shows"],"nullable":true},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["ids"]},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["not_found","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncFavoritesRemove"}},"/sync/favorites/reorder":{"post":{"description":"Reorder all items in a user favorites list by sending the ordered list item IDs.","summary":"Reorder favorited items","tags":["sync","favorites"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"type":"array","items":{"type":"integer"}}},"required":["rank"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"skipped_ids":{"type":"array","items":{"type":"integer"}},"list":{"type":"object","properties":{"updated_at":{"type":"string"},"item_count":{"type":"integer"}},"required":["updated_at","item_count"]}},"required":["updated","skipped_ids","list"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncFavoritesReorder"}},"/sync/favorites/{list_item_id}":{"put":{"description":"Update a single favorite item by list item ID. A successful update returns no response body.","summary":"Update a favorite item","tags":["sync","favorites"],"parameters":[{"name":"list_item_id","in":"path","required":true,"schema":{"type":"string"},"description":"List item ID."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"notes":{"type":"string","nullable":true},"rank":{"type":"integer"}},"additionalProperties":true}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"putSyncFavoritesUpdateItem"}},"/sync/collection/{type}":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nReturns all collected items for a media `type`.","summary":"Get collection","tags":["sync","collection"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Sync media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]},{"type":"object","properties":{"last_collected_at":{"type":"string","nullable":true},"last_updated_at":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"collected_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["number","collected_at"]}}},"required":["number","episodes"]},"nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionAll"}},"/sync/collection/movies":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns movies in the authenticated user collection. Use `available_on` and pagination to filter and move through collected movies.","summary":"Get movie collection","tags":["sync","collection"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionMovies"}},"/sync/collection/shows":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nReturns shows in the authenticated user collection, including collected seasons and episodes.","summary":"Get show collection","tags":["sync","collection"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"last_collected_at":{"type":"string","nullable":true},"last_updated_at":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"collected_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["number","collected_at"]}}},"required":["number","episodes"]},"nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionShows"}},"/sync/collection/episodes":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns episodes in the authenticated user collection. Use `available_on` and pagination to filter and move through collected episodes.","summary":"Get episode collection","tags":["sync","collection"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionEpisodes"}},"/sync/collection/media":{"get":{"description":"#### 🔒 OAuth Required 📄 Pagination ✨ Extended Info\nReturns movies, shows, and episodes in the authenticated user collection. Use `available_on` and pagination to filter and move through collected media.","summary":"Get media collection","tags":["sync","collection"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]},{"type":"object","properties":{"last_collected_at":{"type":"string","nullable":true},"last_updated_at":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"collected_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["number","collected_at"]}}},"required":["number","episodes"]},"nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"collected_at":{"type":"string"},"updated_at":{"type":"string"},"available_on":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"nullable":true}},"required":["type","collected_at","updated_at"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionMedia"}},"/sync/collection":{"post":{"description":"#### 🔒 OAuth Required\nAdd items to a user collection. Accepts shows, seasons, episodes and movies. A show adds its aired episodes, specials excluded; a season adds its aired episodes. A movie or episode without a release date is returned in `not_found`.\n\nSending an item that is already collected with different metadata updates it, `collected_at` included; a new `collected_at` alone is ignored. Metadata left out of the request is cleared.\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| `movies` | array | Array of `movie` objects. (see examples ->) |\n| `shows` | array | Array of `show` objects. |\n| `seasons` | array | Array of `season` objects. |\n| `episodes` | array | Array of `episode` objects. |\n\n#### Media Object POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie`, `show`, `season`, or `episode` object. |\n| `collected_at` | datetime | UTC datetime when the item was collected. Set to `released` for the release date, `unknown` for no specific date, or `now`. |\n| `media_type` | string | Physical or digital format, e.g. `bluray`. |\n| `resolution` | string | e.g. `uhd_4k`. |\n| `hdr` | string | e.g. `dolby_vision`. |\n| `audio` | string | e.g. `dolby_atmos`. |\n| `audio_channels` | string | e.g. `7.1`. |\n| `3d` | boolean | Set to `true` for 3D media. |","summary":"Add items to collection","tags":["sync","collection"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["number"]},"nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["number"]},"nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["ids"]},"nullable":true}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"updated":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"existing":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["number"]},"nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["number"]},"nullable":true},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]},"collected_at":{"type":"string","nullable":true,"description":"When the item was collected: a UTC datetime, `released` for its release date, `unknown` for no specific date, or `now` for the current time. Defaults to the stored date, else now."},"media_type":{"type":"string","enum":["digital","bluray","hddvd","dvd","vcd","vhs","betamax","laserdisc"],"nullable":true},"resolution":{"type":"string","enum":["uhd_4k","hd_1080p","hd_1080i","hd_720p","sd_480p","sd_480i","sd_576p","sd_576i"],"nullable":true},"hdr":{"type":"string","enum":["dolby_vision","hdr10","hdr10_plus","hlg"],"nullable":true},"audio":{"type":"string","enum":["lpcm","mp3","mp2","aac","ogg","ogg_opus","wma","flac","dts","dts_ma","dts_hr","dts_x","auro_3d","dolby_digital","dolby_digital_plus","dolby_digital_plus_atmos","dolby_atmos","dolby_truehd","dolby_prologic"],"nullable":true},"audio_channels":{"type":"string","enum":["1.0","2.0","2.1","3.0","3.1","4.0","4.1","5.0","5.1","5.1.2","5.1.4","6.1","7.1","7.1.2","7.1.4","9.1","10.1"],"nullable":true},"3d":{"type":"boolean","nullable":true}},"required":["ids"]},"nullable":true}}}},"required":["added","updated","existing","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncCollectionAdd"}},"/sync/collection/remove":{"post":{"description":"#### 🔒 OAuth Required\nRemove items from a user collection. Accepts shows, seasons, episodes and movies. A show or season removes every collected episode it holds.","summary":"Remove items from collection","tags":["sync","collection"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"object","properties":{"movies":{"type":"integer"},"episodes":{"type":"integer"}},"required":["movies","episodes"]},"not_found":{"type":"object","properties":{"movies":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true}}},"nullable":true},"shows":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}],"nullable":true},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"}},"required":["number"]},"nullable":true}},"required":["number"]},"nullable":true}}},"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true},"episodes":{"type":"array","items":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"]},"nullable":true}}}},"required":["deleted","not_found"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postSyncCollectionRemove"}},"/sync/collection/minimal/movies":{"get":{"description":"#### 🔒 OAuth Required\nReturns the authenticated user movie collection in a minimal format optimized for syncing local state.","summary":"Get minimal movie collection","tags":["sync","collection","minimal"],"parameters":[{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionMinimalMovies"}},"/sync/collection/minimal/shows":{"get":{"description":"#### 🔒 OAuth Required\nReturns the authenticated user show collection in a minimal format optimized for syncing local state.","summary":"Get minimal show collection","tags":["sync","collection","minimal"],"parameters":[{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionMinimalShows"}},"/sync/collection/minimal/episodes":{"get":{"description":"#### 🔒 OAuth Required\nReturns the authenticated user episode collection in a minimal format optimized for syncing local state.","summary":"Get minimal episode collection","tags":["sync","collection","minimal"],"parameters":[{"name":"available_on","in":"query","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getSyncCollectionMinimalEpisodes"}},"/recommendations/movies/":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nMovie recommendations for a user. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. Set `ignore_collected=true` to filter out movies the user has already collected or `ignore_watchlisted=true` to filter out movies the user has already watchlisted.\n\nThe `favorited_by` array contains all users who favorited the item along with any notes they added.","summary":"Get movie recommendations","tags":["recommendations","movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"limit","in":"query","description":"Limit the number of results.","required":true,"schema":{"type":"integer"}},{"name":"watch_window","in":"query","description":"The watch window in days for the recommendations.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true},"favorited_by":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true},"notes":{"type":"string"}},"required":["username","private","deleted","ids","notes"]},"nullable":true},"recommended_by":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true},"notes":{"type":"string"}},"required":["username","private","deleted","ids","notes"]},"nullable":true}},"required":["title","ids","favorited_by","recommended_by"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getRecommendationsMoviesRecommend"}},"/recommendations/movies/{id}":{"delete":{"description":"#### 🔒 OAuth Required\nHide a movie from getting recommended anymore.","summary":"Hide a movie recommendation","tags":["recommendations","movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteRecommendationsMoviesHide"}},"/recommendations/shows/":{"get":{"description":"#### 🔒 OAuth Required ✨ Extended Info\nTV show recommendations for a user. By default, `10` results are returned. You can send a `limit` to get up to `100` results per page. Set `ignore_collected=true` to filter out shows the user has already collected or `ignore_watchlisted=true` to filter out shows the user has already watchlisted.\n\nThe `favorited_by` array contains all users who favorited the item along with any notes they added.","summary":"Get show recommendations","tags":["recommendations","shows"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"limit","in":"query","description":"Limit the number of results.","required":true,"schema":{"type":"integer"}},{"name":"watch_window","in":"query","description":"The watch window in days for the recommendations.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true},"favorited_by":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true},"notes":{"type":"string"}},"required":["username","private","deleted","ids","notes"]},"nullable":true},"recommended_by":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true},"notes":{"type":"string"}},"required":["username","private","deleted","ids","notes"]},"nullable":true}},"required":["title","ids","favorited_by","recommended_by"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getRecommendationsShowsRecommend"}},"/recommendations/shows/{id}":{"delete":{"description":"#### 🔒 OAuth Required\nHide a show from getting recommended anymore.","summary":"Hide a show recommendation","tags":["recommendations","shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteRecommendationsShowsHide"}},"/media/trending":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns trending movies and shows. Results are ordered by current watcher activity and can be filtered by media fields or ignored user state.","summary":"Get trending media","tags":["media"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watchers":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["watchers"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMediaTrending"}},"/media/anticipated":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns anticipated movies and shows based on list activity. Results can be filtered by media fields or ignored user state.","summary":"Get anticipated media","tags":["media"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"list_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["list_count"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMediaAnticipated"}},"/media/popular":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns popular movies and shows. Results can be filtered by media fields or ignored user state.","summary":"Get popular media","tags":["media"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMediaPopular"}},"/movies/{id}":{"get":{"description":"#### ✨ Extended Info\nReturns a single movie's details.\n\n> ### Note\n> _When getting `full` extended info, the `status` field can have a value of `released`, `in production`, `post production`, `planned`, `rumored`, or `canceled`._","summary":"Get a movie","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesSummary"}},"/movies/{id}/ratings":{"get":{"description":"Returns the Trakt rating (between 0 and 10), vote count, and rating distribution for a movie.\n\nUse `?extended=all` to include ratings from TMDB, IMDb, Metascore, Rotten Tomatoes, Letterboxd, and MyAnimeList. External ratings, vote counts, and links can be `null` when unavailable.","summary":"Get movie ratings","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Use `all` to include ratings from supported external sources.","schema":{"type":"string","enum":["all"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"],"nullable":true},"trakt":{"type":"object","properties":{"rating":{"type":"number","format":"float"},"votes":{"type":"integer"},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"]}},"required":["rating","votes","distribution"],"nullable":true},"tmdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"imdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"metascore":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true},"rotten_tomatoes":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"state":{"type":"string","nullable":true},"user_state":{"type":"string","nullable":true}},"nullable":true},"letterboxd":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"mal":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true}}},"examples":{"default":{"summary":"Default response","value":{"distribution":{"1":143,"2":239,"3":115,"4":483,"5":447,"6":2126,"7":2522,"8":6916,"9":3232,"10":8567},"rating":8.29481,"votes":24789}},"extendedAll":{"summary":"Response with `extended=all`","value":{"imdb":{"link":"https://www.imdb.com/title/tt37287335","rating":7.9,"votes":269113},"metascore":{"link":"https://www.imdb.com/title/tt37287335/criticreviews","rating":77},"rotten_tomatoes":{"link":"https://www.rottentomatoes.com/m/obsession_2025","rating":94,"state":"fresh","user_rating":94,"user_state":"upright"},"tmdb":{"link":"https://www.themoviedb.org/movie/1339713","rating":8.251,"votes":3739},"trakt":{"distribution":{"1":143,"2":239,"3":115,"4":483,"5":447,"6":2126,"7":2522,"8":6916,"9":3232,"10":8567},"rating":8.29481,"votes":24789},"letterboxd":{"link":"https://letterboxd.com/film/obsession-2025","rating":4.12,"votes":3633569},"mal":{"link":null,"rating":null,"votes":0}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesRatings"}},"/movies/{id}/stats":{"get":{"description":"Returns lots of movie stats.","summary":"Get movie stats","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"watchers":{"type":"integer"},"plays":{"type":"integer"},"collectors":{"type":"integer"},"comments":{"type":"integer"},"lists":{"type":"integer"},"votes":{"type":"integer"},"favorited":{"type":"integer"},"recommended":{"type":"integer"}},"required":["watchers","plays","collectors","comments","lists","votes","favorited","recommended"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesStats"}},"/movies/{id}/aliases":{"get":{"description":"Returns all title aliases for a movie. Includes localized and alternate titles when available.","summary":"Get all movie aliases","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["title"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesAliases"}},"/movies/{id}/releases/{country}":{"get":{"description":"Returns release dates for a movie in the requested country, including certification and release type when available.","summary":"Get all movie releases","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"2 character country code."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"certification":{"type":"string","nullable":true},"release_date":{"type":"string"},"release_type":{"type":"string"},"note":{"type":"string","nullable":true}},"required":["country","release_date"],"additionalProperties":true}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesReleases"}},"/movies/{id}/translations":{"get":{"description":"Returns all translations for a movie, including language, country, and translated values for title, tagline and overview. The `country` field can be used together with `language` to identify regional variants (for example `fr`/`fr` vs `fr`/`ca`). Use the optional `language` query param to filter to a single language.","summary":"Get all movie translations","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"language","in":"query","description":"Filter translations to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"tagline":{"type":"string","nullable":true},"language":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesTranslations"}},"/movies/{id}/related":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\n\nReturns related and similar movies. Pass `personalized=true` as a VIP to re-order them toward your taste.","summary":"Get related movies","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"personalized","in":"query","description":"When true, VIP and director accounts get the same related titles re-ordered toward their taste. Ignored for everyone else.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesRelated"}},"/movies/{id}/watching":{"get":{"description":"#### ✨ Extended Info\nReturns all users watching this movie right now.","summary":"Get users watching right now","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesWatching"}},"/movies/{id}/studios":{"get":{"description":"Returns all studios for a movie.","summary":"Get movie studios","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]}},"required":["name","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesStudios"}},"/movies/{id}/watchnow/{country}":{"get":{"description":"#### 🫣 Limited Access ✨ Extended Info\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns streaming and watch now sources for a movie in the requested country. Use `links` to include provider links when available.","summary":"Get movie watch now sources","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"2 character country code."},{"name":"links","in":"query","schema":{"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"cable":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"free":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"cinema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"subscription":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"purchase":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"streaming_ranks":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"delta":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true}},"required":["cable","free","cinema","subscription","purchase"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesWatchnow"}},"/movies/{id}/watchnow/justwatch_links/{country}":{"get":{"description":"#### 🫣 Limited Access\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns JustWatch links for a movie in the requested country. Use the movie `id` and two-character `country` path parameter to identify the lookup.","summary":"Get movie JustWatch links","tags":["movies","justwatch"],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesJustwatchLink"}},"/movies/{id}/refresh/justwatch":{"post":{"description":"#### 🔥 VIP Only 🔒 OAuth Required\nQueue a refresh of a movie's JustWatch watch now links.","summary":"Refresh movie JustWatch links","tags":["movies","justwatch"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postMoviesJustwatchRefresh"}},"/movies/{id}/people":{"get":{"description":"#### ✨ Extended Info\nReturns all `cast` and `crew` for a movie. Each `cast` member will have a `characters` array and a standard `person` object.\n\nThe `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object.\n\n#### Markdown\nIf you add `?extended=markdown` to the URL, person biographies include links to the movies and shows they mention. Without it the biography is plain text.","summary":"Get all people for a movie","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"guest_stars":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"episode_count":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["person","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesPeople"}},"/movies/{id}/videos":{"get":{"description":"#### ✨ Extended Info\nReturns all videos including trailers, teasers, clips, and featurettes.","summary":"Get all videos","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"site":{"type":"string"},"type":{"type":"string"},"size":{"type":"integer"},"official":{"type":"boolean"},"published_at":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}},"required":["title","url","site","type","size","official","published_at","country","language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesVideos"}},"/movies/{id}/lists/{type}/{sort}":{"get":{"description":"#### 📄 Pagination 😁 Emojis\n\nReturns all lists that contain this movie. By default, `personal` lists are returned sorted by the most `popular`.","summary":"Get lists containing this movie","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["popular","likes","comments","items","added","updated"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","personal","official","watchlist","favorites"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesLists"}},"/movies/{id}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for a movie. By default, comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all movie comments","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies","highest","lowest","plays"],"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"language","in":"query","description":"Filter comments to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesComments"}},"/movies/{id}/sentiments":{"get":{"description":"Returns sentiment counts for comments and reactions attached to a movie.","summary":"Get movie sentiments","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"bad":{"type":"array","items":{"type":"object","properties":{"sentiment":{"type":"string"},"comment_ids":{"type":"array","items":{"type":"integer"},"nullable":true}},"required":["sentiment"]}},"good":{"type":"array","items":{"type":"object","properties":{"sentiment":{"type":"string"},"comment_ids":{"type":"array","items":{"type":"integer"},"nullable":true}},"required":["sentiment"]}},"analyzed_at":{"type":"string"},"comment_count":{"type":"integer"}},"required":["bad","good","analyzed_at","comment_count"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesSentiments"}},"/movies/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a movie for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per movie.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another movie on Trakt |\n| `remove` | Should be removed from Trakt |\n| `data_refresh` | Request a full metadata refresh |\n| `metadata` | Metadata is wrong (title, overview, etc) |\n| `adult` | Marked as adult when it shouldn't be (or vice versa) |\n| `runtime` | Runtime is incorrect |\n| `language` | Not in English |\n| `spam` | Spam or fake title |\n| `tmdb` | Should use TMDB as the datasource |\n| `other` | Anything else (add details in `message`) |","summary":"Report a movie","tags":["movies"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postMoviesReport"}},"/movies/trending":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most watched movies over the last 24 hours. Movies with the most `watchers` are returned first.","summary":"Get trending movies","tags":["movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watchers":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watchers","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesTrending"}},"/movies/watched/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most watched (unique users) movies in the specified time `period`, defaulting to `weekly`. All stats are relative to the specific time `period`.","summary":"Get the most watched movies","tags":["movies"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesWatched"}},"/movies/favorited/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most favorited movies in the specified time `period`, defaulting to `weekly`.","summary":"Get the most favorited movies","tags":["movies"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"user_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["user_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesFavorited"}},"/movies/played/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most played movies in the specified time `period`, defaulting to `weekly`.","summary":"Get the most played movies","tags":["movies"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesPlayed"}},"/movies/collected/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most collected movies in the specified time `period`, defaulting to `weekly`.","summary":"Get the most collected movies","tags":["movies"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesCollected"}},"/movies/boxoffice":{"get":{"description":"Returns the top 10 grossing movies in the U.S. box office last weekend. Updated every Monday morning.","summary":"Get the weekend box office","tags":["movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"revenue":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesBoxoffice"}},"/movies/updates/{start_date}":{"get":{"description":"Returns all movies updated since the specified UTC date. We recommend storing the latest `updated_at` locally and using it for the next request.","summary":"Get recently updated movies","tags":["movies"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"updated_at":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["updated_at","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesUpdates"}},"/movies/updates/id/{start_date}":{"get":{"description":"Returns Trakt IDs for movies updated since the specified UTC date.","summary":"Get recently updated movie Trakt IDs","tags":["movies"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"integer"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesUpdatedIds"}},"/movies/anticipated":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most anticipated movies based on the number of lists a movie appears on.","summary":"Get the most anticipated movies","tags":["movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"list_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["list_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesAnticipated"}},"/movies/hot":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movies that are currently hot on Trakt. Results can be filtered by media fields or ignored user state.","summary":"Get hot movies","tags":["movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"list_count":{"type":"integer"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["list_count","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesHot"}},"/movies/popular":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most popular movies. Popularity is calculated using the rating percentage and the number of ratings.","summary":"Get popular movies","tags":["movies"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesPopular"}},"/movies/streaming/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns movies recently available on streaming services for the requested `period`. Results can be filtered by media fields or ignored user state.","summary":"Get streaming movies","tags":["movies"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"delta":{"type":"integer","nullable":true},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getMoviesStreaming"}},"/notes":{"post":{"description":"#### 🔒 OAuth Required 😁 Emojis\nAdd a new note to a movie, show, season, episode, person, or list.","summary":"Add notes","tags":["notes"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"notes":{"type":"string"},"privacy":{"type":"string"},"spoiler":{"type":"boolean"}},"additionalProperties":true}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"notes":{"type":"string","nullable":true},"privacy":{"type":"string"},"spoiler":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postNotesCreate"}},"/notes/{id}":{"get":{"description":"Returns a single note.","summary":"Get a note","tags":["notes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"notes":{"type":"string","nullable":true},"privacy":{"type":"string"},"spoiler":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getNotesSummary"},"put":{"description":"Update a single note.","summary":"Update a note","tags":["notes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true},"notes":{"type":"string"},"privacy":{"type":"string"},"spoiler":{"type":"boolean"}},"additionalProperties":true}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"notes":{"type":"string","nullable":true},"privacy":{"type":"string"},"spoiler":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"putNotesUpdate"},"delete":{"description":"Delete a single note.","summary":"Delete a note","tags":["notes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteNotesDelete"}},"/notes/{id}/item":{"get":{"description":"Returns the media item this note is attached to. The media type can be `movie`, `show`, `season`, `episode`, `person`, or `list` and it also returns the standard media object for that media type.","summary":"Get the attached item","tags":["notes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"}},"additionalProperties":true}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getNotesItem"}},"/shows/{id}":{"get":{"description":"#### ✨ Extended Info\nReturns a single shows's details. If you request extended info, the `airs` object is relative to the show's country. You can use the `day`, `time`, and `timezone` to construct your own date then convert it to whatever timezone your user is in.\n\n> ### Note\n> _When getting `full` extended info, the `status` field can have a value of `returning series` (airing right now), `continuing` (airing right now), `in production` (airing soon), `planned` (in development), `upcoming` (in development), `pilot`, `canceled`, or `ended`._","summary":"Get a single show","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSummary"}},"/shows/{id}/ratings":{"get":{"description":"Returns the Trakt rating (between 0 and 10), vote count, and rating distribution for a show.\n\nUse `?extended=all` to include ratings from TMDB, IMDb, Metascore, Rotten Tomatoes, and MyAnimeList. External ratings, vote counts, and links can be `null` when unavailable.","summary":"Get show ratings","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Use `all` to include ratings from supported external sources.","schema":{"type":"string","enum":["all"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"],"nullable":true},"trakt":{"type":"object","properties":{"rating":{"type":"number","format":"float"},"votes":{"type":"integer"},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"]}},"required":["rating","votes","distribution"],"nullable":true},"tmdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"imdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"metascore":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true},"rotten_tomatoes":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"state":{"type":"string","nullable":true},"user_state":{"type":"string","nullable":true}},"nullable":true},"mal":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true}}},"examples":{"default":{"summary":"Default response","value":{"distribution":{"1":143,"2":239,"3":115,"4":483,"5":447,"6":2126,"7":2522,"8":6916,"9":3232,"10":8567},"rating":8.29481,"votes":24789}},"extendedAll":{"summary":"Response with `extended=all`","value":{"imdb":{"link":"https://www.imdb.com/title/tt9813792","rating":7.8,"votes":199521},"metascore":{"link":"https://www.imdb.com/title/tt9813792/criticreviews","rating":63},"rotten_tomatoes":{"link":"https://www.rottentomatoes.com/tv/from","rating":96,"state":"fresh","user_rating":76,"user_state":"upright"},"tmdb":{"link":"https://www.themoviedb.org/tv/124364","rating":8.5,"votes":4037},"trakt":{"distribution":{"1":122,"2":87,"3":88,"4":215,"5":673,"6":1102,"7":2599,"8":4266,"9":2285,"10":4491},"rating":8.11106,"votes":15928},"mal":{"link":null,"rating":null,"votes":0}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsRatings"}},"/shows/{id}/stats":{"get":{"description":"Returns lots of show stats.","summary":"Get show stats","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"watchers":{"type":"integer"},"plays":{"type":"integer"},"collectors":{"type":"integer"},"comments":{"type":"integer"},"lists":{"type":"integer"},"votes":{"type":"integer"},"favorited":{"type":"integer"},"recommended":{"type":"integer"}},"required":["watchers","plays","collectors","comments","lists","votes","favorited","recommended"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsStats"}},"/shows/{id}/aliases":{"get":{"description":"Returns all title aliases for a show. Includes localized and alternate titles when available.","summary":"Get all show aliases","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["title"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsAliases"}},"/shows/{id}/certifications":{"get":{"description":"Returns all content certifications for a show, grouped by country.","summary":"Get all show certifications","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"string"}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsCertifications"}},"/shows/{id}/progress/collection":{"get":{"description":"#### 🔒 OAuth Required\nReturns collection progress for a show including details on all aired seasons and episodes. The `next_episode` will be the next episode the user should collect, if there are no upcoming episodes it will be set to `null`.\n\nBy default, any hidden seasons will be removed from the response and stats. To include these and adjust the completion stats, set the `hidden` flag to `true`.\n\nBy default, the `last_episode` and `next_episode` are calculated using the last `aired` episode the user has collected, even if they've collected older episodes more recently. To use their last collected episode for these calculations, set the `last_activity` flag to `collected`.","summary":"Get show collection progress","tags":["shows","progress"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"hidden","in":"query","description":"Whether to include any hidden seasons","schema":{"type":"boolean","nullable":true}},{"name":"specials","in":"query","description":"Whether to include special seasons as season 0.","schema":{"type":"boolean","nullable":true}},{"name":"count_specials","in":"query","description":"Whether to count specials in the overall stats (only applies if specials are included).","schema":{"type":"boolean","nullable":true}},{"name":"last_activity","in":"query","description":"Which episode `last_episode` and `next_episode` are calculated from.","schema":{"type":"string","enum":["aired","collected"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"aired":{"type":"integer"},"completed":{"type":"integer"},"last_collected_at":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"title":{"type":"string","nullable":true},"aired":{"type":"integer"},"completed":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"completed":{"type":"boolean"},"collected_at":{"type":"string","nullable":true}},"required":["number","completed"]}}},"required":["number","aired","completed","episodes"]}},"hidden_seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]}},"required":["number","ids"]}},"next_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"last_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true}},"required":["aired","completed","seasons","hidden_seasons","next_episode","last_episode"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsProgressCollection"}},"/shows/{id}/progress/watched":{"get":{"description":"#### 🔒 OAuth Required\nReturns watched progress for a show including details on all aired seasons and episodes. The `next_episode` will be the next episode the user should watch, if there are no upcoming episodes it will be set to `null`. If not `null`, the `reset_at` date is when the user started re-watching the show. Your app can adjust the progress by ignoring episodes with a `last_watched_at` prior to the `reset_at`.\n\nBy default, any hidden seasons will be removed from the response and stats. To include these and adjust the completion stats, set the `hidden` flag to `true`.\n\nBy default, specials will be excluded from the response. Set the `specials` flag to `true` to include season 0 and adjust the stats accordingly. If you'd like to include specials, but not adjust the stats, set `count_specials` to `false`.\n\nBy default, the `last_episode` and `next_episode` are calculated using the last `aired` episode the user has watched, even if they've watched older episodes more recently. To use their last watched episode for these calculations, set the `last_activity` flag to `watched`.\n\n> ### Note\n> _Only aired episodes are used to calculate progress. Episodes in the future or without an air date are ignored._","summary":"Get show watched progress","tags":["shows","progress"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"hidden","in":"query","description":"Whether to include any hidden seasons","schema":{"type":"boolean","nullable":true}},{"name":"specials","in":"query","description":"Whether to include special seasons as season 0.","schema":{"type":"boolean","nullable":true}},{"name":"count_specials","in":"query","description":"Whether to count specials in the overall stats (only applies if specials are included).","schema":{"type":"boolean","nullable":true}},{"name":"include_stats","in":"query","description":"Whether to include stats in the response","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"aired":{"type":"integer"},"completed":{"type":"integer"},"last_watched_at":{"type":"string","nullable":true},"reset_at":{"type":"string","format":"null","nullable":true},"next_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"last_episode":{"oneOf":[{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"string","format":"null","nullable":true}],"nullable":true},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true},"seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"title":{"type":"string","nullable":true},"aired":{"type":"integer"},"completed":{"type":"integer"},"episodes":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"completed":{"type":"boolean"},"last_watched_at":{"type":"string","nullable":true},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true}},"required":["number","completed"]}},"stats":{"type":"object","properties":{"play_count":{"type":"integer"},"minutes_watched":{"type":"integer"},"minutes_left":{"type":"integer","nullable":true}},"required":["play_count","minutes_watched"],"nullable":true}},"required":["number","aired","completed","episodes"]}},"hidden_seasons":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]}},"required":["number","ids"]}}},"required":["aired","completed","reset_at","next_episode","last_episode","seasons","hidden_seasons"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsProgressWatched"}},"/shows/{id}/progress/watched/reset":{"post":{"description":"#### 🔥 VIP Only 🔒 OAuth Required\nReset a show progress. This starts re-watching a show and allows watched progress calculations to ignore previous watches. Send an optional `reset_at` to start the reset from an earlier time; it defaults to now.","summary":"Reset show progress","tags":["shows","progress"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reset_at":{"type":"string","nullable":true,"description":"UTC datetime the reset starts from; defaults to now. Cannot be in the future."}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"reset_at":{"type":"string"}},"required":["reset_at"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postShowsProgressReset"},"delete":{"description":"#### 🔥 VIP Only 🔒 OAuth Required\nUndo a show progress reset and restore normal watched progress calculations.","summary":"Undo reset show progress","tags":["shows","progress"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteShowsProgressUndoReset"}},"/shows/{id}/translations":{"get":{"description":"Returns all translations for a show, including language, country, and translated values for title, tagline and overview. The `country` field can be used together with `language` to identify regional variants (for example `fr`/`fr` vs `fr`/`ca`). Use the optional `language` query param to filter to a single language.","summary":"Get all show translations","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"language","in":"query","description":"Filter translations to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"tagline":{"type":"string","nullable":true},"language":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsTranslations"}},"/shows/{id}/related":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\n\nReturns related and similar shows. Pass `personalized=true` as a VIP to re-order them toward your taste.","summary":"Get related shows","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"personalized","in":"query","description":"When true, VIP and director accounts get the same related titles re-ordered toward their taste. Ignored for everyone else.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsRelated"}},"/shows/{id}/watching":{"get":{"description":"#### ✨ Extended Info\nReturns all users watching this show right now.","summary":"Get users watching right now","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsWatching"}},"/shows/{id}/next_episode":{"get":{"description":"Returns the next scheduled episode for a show. If no episode is found, a `204` response is returned.","summary":"Get next episode","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]}}}},"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsNextEpisode"}},"/shows/{id}/last_episode":{"get":{"description":"Returns the most recently aired episode for a show. If no episode is found, a `204` response is returned.","summary":"Get last episode","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]}}}},"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsLastEpisode"}},"/shows/{id}/studios":{"get":{"description":"Returns all studios for a show.","summary":"Get show studios","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]}},"required":["name","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsStudios"}},"/shows/{id}/watchnow/{country}":{"get":{"description":"#### 🫣 Limited Access ✨ Extended Info\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns streaming and watch now sources for a show in the requested country. Use `links` to include provider links when available.","summary":"Get show watch now sources","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"2 character country code."},{"name":"links","in":"query","schema":{"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"cable":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"free":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"cinema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"subscription":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"purchase":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"streaming_ranks":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"delta":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true}},"required":["cable","free","cinema","subscription","purchase"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsWatchnow"}},"/shows/{id}/watchnow/justwatch_links/{country}":{"get":{"description":"#### 🫣 Limited Access\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns JustWatch links for a show in the requested country. Use the show `id` and two-character `country` path parameter to identify the lookup.","summary":"Get show JustWatch links","tags":["shows","justwatch"],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsJustwatchLink"}},"/shows/{id}/refresh/justwatch":{"post":{"description":"#### 🔥 VIP Only 🔒 OAuth Required\nQueue a refresh of a show's JustWatch watch now links.","summary":"Refresh show JustWatch links","tags":["shows","justwatch"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postShowsJustwatchRefresh"}},"/shows/{id}/people":{"get":{"description":"#### ✨ Extended Info\nReturns all `cast` and `crew` for a show, including the `episode_count` for which they appears. Each `cast` member will have a `characters` array and a standard `person` object.\n\nThe `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, `editing`, and `created by` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object.\n\n#### Guest Stars\nIf you add `?extended=guest_stars` to the URL, it will return all guest stars that appeared in at least 1 episode of the show.\n\n> ### Note\n> _This returns a lot of data, so please only use this extended parameter if you actually need it!_\n\n#### Markdown\nIf you add `?extended=markdown` to the URL, person biographies include links to the movies and shows they mention. Without it the biography is plain text.","summary":"Get all people for a show","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"guest_stars":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"episode_count":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["person","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsPeople"}},"/shows/{id}/seasons":{"get":{"description":"#### ✨ Extended Info\nReturns all seasons for a show including the number of episodes in each season.\n\n#### Episodes\nIf you add `?extended=episodes` to the URL, it will return all episodes for all seasons.\n\n> ### Note\n> _This returns a lot of data, so please only use this extended parameter if you actually need it!_","summary":"Get all seasons for a show","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasons"}},"/shows/{id}/seasons/{season}/info":{"get":{"description":"Returns a single season for a show including the number of episodes in that season.","summary":"Get single seasons for a show","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonInfo"}},"/shows/{id}/seasons/{season}":{"get":{"description":"#### ✨ Extended Info\nReturns all episodes for a specific season of a show.\n\n#### Translations\nIf you'd like to included translated episode titles and overviews in the response, include the `translations` parameter in the URL. Include all languages by setting the parameter to `all` or use a specific 2 digit country language code to further limit it. Each translation includes both `language` and `country` so regional variants (for example `fr`/`fr` vs `fr`/`ca`) can be distinguished.\n\n> ### Note\n> _This returns a lot of data, so please only use this extended parameter if you actually need it!_","summary":"Get all episodes for a single season","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonEpisodes"}},"/shows/{id}/seasons/{season}/translations":{"get":{"description":"Returns all translations for a season, including language, country, and translated title and overview values. Use the optional `language` query param to filter to a single language.","summary":"Get all season translations","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"language","in":"query","description":"Filter translations to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"tagline":{"type":"string","nullable":true},"language":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonTranslations"}},"/shows/{id}/seasons/{season}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for a season. By default, comments are sorted by most `likes`.","summary":"Get all season comments","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies","highest","lowest","plays"],"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"language","in":"query","description":"Filter comments to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonComments"}},"/shows/{id}/seasons/{season}/lists/{type}/{sort}":{"get":{"description":"#### 📄 Pagination 😁 Emojis\n\nReturns all lists that contain this season. By default, `personal` lists are returned sorted by the most `popular`.","summary":"Get lists containing this season","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["popular","likes","comments","items","added","updated"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","personal","official","watchlist","favorites"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonLists"}},"/shows/{id}/seasons/{season}/people":{"get":{"description":"Returns all cast and crew for a season. Each cast member will have a characters array and a standard person object. Add `?extended=markdown` to include links to the movies and shows in person biographies; without it the biography is plain text.","summary":"Get all people for a season","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"guest_stars":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"episode_count":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["person","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonPeople"}},"/shows/{id}/seasons/{season}/ratings":{"get":{"description":"Returns the Trakt rating (between 0 and 10), vote count, and rating distribution for a season.\n\nUse `?extended=all` to include ratings from TMDB, IMDb, Metascore, and Rotten Tomatoes. External ratings, vote counts, and links can be `null` when unavailable.","summary":"Get season ratings","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"extended","in":"query","description":"Use `all` to include ratings from supported external sources.","schema":{"type":"string","enum":["all"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"],"nullable":true},"trakt":{"type":"object","properties":{"rating":{"type":"number","format":"float"},"votes":{"type":"integer"},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"]}},"required":["rating","votes","distribution"],"nullable":true},"tmdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"imdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"metascore":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true},"rotten_tomatoes":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"state":{"type":"string","nullable":true},"user_state":{"type":"string","nullable":true}},"nullable":true}}},"examples":{"default":{"summary":"Default response","value":{"distribution":{"1":143,"2":239,"3":115,"4":483,"5":447,"6":2126,"7":2522,"8":6916,"9":3232,"10":8567},"rating":8.29481,"votes":24789}},"extendedAll":{"summary":"Response with `extended=all`","value":{"imdb":{"link":"https://www.imdb.com/title/tt9813792","rating":7.8,"votes":199521},"metascore":{"link":"https://www.imdb.com/title/tt9813792/criticreviews","rating":63},"rotten_tomatoes":{"link":"https://www.rottentomatoes.com/tv/from","rating":96,"state":"fresh","user_rating":76,"user_state":"upright"},"tmdb":{"link":"https://www.themoviedb.org/tv/124364","rating":8.5,"votes":4037},"trakt":{"distribution":{"1":122,"2":87,"3":88,"4":215,"5":673,"6":1102,"7":2599,"8":4266,"9":2285,"10":4491},"rating":8.11106,"votes":15928}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonRatings"}},"/shows/{id}/seasons/{season}/stats":{"get":{"description":"Returns lots of season stats.","summary":"Get season stats","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"watchers":{"type":"integer"},"plays":{"type":"integer"},"collectors":{"type":"integer"},"comments":{"type":"integer"},"lists":{"type":"integer"},"votes":{"type":"integer"}},"required":["watchers","plays","collectors","comments","lists","votes"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonStats"}},"/shows/{id}/seasons/{season}/watching":{"get":{"description":"#### ✨ Extended Info\nReturns all users watching this season right now.","summary":"Get users watching right now","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonWatching"}},"/shows/{id}/seasons/{season}/videos":{"get":{"description":"#### ✨ Extended Info\nReturns all videos including trailers, teasers, clips, and featurettes.","summary":"Get all videos","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"site":{"type":"string"},"type":{"type":"string"},"size":{"type":"integer"},"official":{"type":"boolean"},"published_at":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}},"required":["title","url","site","type","size","official","published_at","country","language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonVideos"}},"/shows/{id}/seasons/{season}/watchnow/justwatch_links/{country}":{"get":{"description":"#### 🫣 Limited Access\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns JustWatch links for a show season in the requested country. Use `id`, `season`, and the two-character `country` path parameter to identify the lookup.","summary":"Get season JustWatch links","tags":["shows","season","justwatch"],"parameters":[{"name":"season","in":"path","required":true,"schema":{"type":"string"}},{"name":"country","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSeasonJustwatchLink"}},"/shows/{id}/seasons/{season}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a season for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per season.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another season on Trakt |\n| `remove` | Should be removed from Trakt |\n| `data_refresh` | Request a full metadata refresh |\n| `metadata` | Metadata is wrong (title, overview, etc) |\n| `adult` | Marked as adult when it shouldn't be (or vice versa) |\n| `runtime` | Runtime is incorrect |\n| `language` | Not in English |\n| `spam` | Spam or fake season |\n| `tmdb` | Should use TMDB as the datasource |\n| `other` | Anything else (add details in `message`) |","summary":"Report a season","tags":["shows","season"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postShowsSeasonReport"}},"/shows/{id}/videos":{"get":{"description":"#### ✨ Extended Info\nReturns all videos including trailers, teasers, clips, and featurettes.","summary":"Get all videos","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"site":{"type":"string"},"type":{"type":"string"},"size":{"type":"integer"},"official":{"type":"boolean"},"published_at":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}},"required":["title","url","site","type","size","official","published_at","country","language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsVideos"}},"/shows/{id}/lists/{type}/{sort}":{"get":{"description":"#### 📄 Pagination 😁 Emojis\n\nReturns all lists that contain this show. By default, `personal` lists are returned sorted by the most `popular`.","summary":"Get lists containing this show","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["popular","likes","comments","items","added","updated"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","personal","official","watchlist","favorites"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsLists"}},"/shows/{id}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for a show. By default, comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, highest `watched` percentage, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all show comments","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies","highest","lowest","plays"],"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"language","in":"query","description":"Filter comments to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsComments"}},"/shows/{id}/sentiments":{"get":{"description":"Returns sentiment counts for comments and reactions attached to a show.","summary":"Get show sentiments","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"bad":{"type":"array","items":{"type":"object","properties":{"sentiment":{"type":"string"},"comment_ids":{"type":"array","items":{"type":"integer"},"nullable":true}},"required":["sentiment"]}},"good":{"type":"array","items":{"type":"object","properties":{"sentiment":{"type":"string"},"comment_ids":{"type":"array","items":{"type":"integer"},"nullable":true}},"required":["sentiment"]}},"analyzed_at":{"type":"string"},"comment_count":{"type":"integer"}},"required":["bad","good","analyzed_at","comment_count"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsSentiments"}},"/shows/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a show for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per show.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another show on Trakt |\n| `remove` | Should be removed from Trakt |\n| `data_refresh` | Request a full metadata refresh |\n| `metadata` | Metadata is wrong (title, overview, etc) |\n| `adult` | Marked as adult when it shouldn't be (or vice versa) |\n| `runtime` | Runtime is incorrect |\n| `language` | Not in English |\n| `spam` | Spam or fake title |\n| `tmdb` | Should use TMDB as the datasource |\n| `other` | Anything else (add details in `message`) |","summary":"Report a show","tags":["shows"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postShowsReport"}},"/shows/{id}/seasons/{season}/episodes/{episode}":{"get":{"description":"#### ✨ Extended Info\nReturns a single episode's details. All date and times are in UTC and were calculated using the episode's `air_date` and show's `country` and `air_time`.\n\n> ### Note\n> _If the `first_aired` is unknown, it will be set to `null`._\n\n> ### Note\n> _When getting `full` extended info, the `episode_type` field can have a value of `standard`, `series_premiere` (season 1, episode 1), `season_premiere` (episode 1), `mid_season_finale`, `mid_season_premiere` (the next episode after the mid season finale), `season_finale`, or `series_finale` (last episode to air for an ended show)._","summary":"Get a single episode for a show","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeSummary"}},"/shows/{id}/seasons/{season}/episodes/{episode}/translations":{"get":{"description":"Returns all translations for an episode, including language, country, and translated values for title and overview. The `country` field can be used together with `language` to identify regional variants (for example `fr`/`fr` vs `fr`/`ca`). Use the optional `language` query param to filter to a single language.","summary":"Get all episode translations","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"language","in":"query","description":"Filter translations to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"language":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeTranslations"}},"/shows/{id}/seasons/{season}/episodes/{episode}/stats":{"get":{"description":"Returns lots of episode stats.","summary":"Get episode stats","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"watchers":{"type":"integer"},"plays":{"type":"integer"},"collectors":{"type":"integer"},"comments":{"type":"integer"},"lists":{"type":"integer"},"votes":{"type":"integer"}},"required":["watchers","plays","collectors","comments","lists","votes"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeStats"}},"/shows/{id}/seasons/{season}/episodes/{episode}/ratings":{"get":{"description":"Returns the Trakt rating (between 0 and 10), vote count, and rating distribution for an episode.\n\nUse `?extended=all` to include ratings from TMDB, IMDb, Metascore, and Rotten Tomatoes. External ratings, vote counts, and links can be `null` when unavailable.","summary":"Get episode ratings","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"extended","in":"query","description":"Use `all` to include ratings from supported external sources.","schema":{"type":"string","enum":["all"],"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"],"nullable":true},"trakt":{"type":"object","properties":{"rating":{"type":"number","format":"float"},"votes":{"type":"integer"},"distribution":{"type":"object","properties":{"1":{"type":"number","format":"float"},"2":{"type":"number","format":"float"},"3":{"type":"number","format":"float"},"4":{"type":"number","format":"float"},"5":{"type":"number","format":"float"},"6":{"type":"number","format":"float"},"7":{"type":"number","format":"float"},"8":{"type":"number","format":"float"},"9":{"type":"number","format":"float"},"10":{"type":"number","format":"float"}},"required":["1","2","3","4","5","6","7","8","9","10"]}},"required":["rating","votes","distribution"],"nullable":true},"tmdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"imdb":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"votes":{"type":"integer","nullable":true}},"nullable":true},"metascore":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true},"rotten_tomatoes":{"type":"object","properties":{"rating":{"type":"number","format":"float","nullable":true},"link":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"state":{"type":"string","nullable":true},"user_state":{"type":"string","nullable":true}},"nullable":true}}},"examples":{"default":{"summary":"Default response","value":{"distribution":{"1":143,"2":239,"3":115,"4":483,"5":447,"6":2126,"7":2522,"8":6916,"9":3232,"10":8567},"rating":8.29481,"votes":24789}},"extendedAll":{"summary":"Response with `extended=all`","value":{"imdb":{"link":"https://www.imdb.com/title/tt9813792","rating":7.8,"votes":199521},"metascore":{"link":"https://www.imdb.com/title/tt9813792/criticreviews","rating":63},"rotten_tomatoes":{"link":"https://www.rottentomatoes.com/tv/from","rating":96,"state":"fresh","user_rating":76,"user_state":"upright"},"tmdb":{"link":"https://www.themoviedb.org/tv/124364","rating":8.5,"votes":4037},"trakt":{"distribution":{"1":122,"2":87,"3":88,"4":215,"5":673,"6":1102,"7":2599,"8":4266,"9":2285,"10":4491},"rating":8.11106,"votes":15928}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeRatings"}},"/shows/{id}/seasons/{season}/episodes/{episode}/watching":{"get":{"description":"#### ✨ Extended Info\nReturns all users watching this episode right now.","summary":"Get users watching right now","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeWatching"}},"/shows/{id}/seasons/{season}/episodes/{episode}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for an episode. By default, comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all episode comments","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["newest","oldest","likes","replies","highest","lowest","plays"],"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"language","in":"query","description":"Filter comments to a 2 character language code","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeComments"}},"/shows/{id}/seasons/{season}/episodes/{episode}/people":{"get":{"description":"#### ✨ Extended Info\nReturns all `cast` and `crew` for an episode. Each `cast` member will have a `characters` array and a standard `person` object.\n\nThe `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `person` object.\n\n#### Guest Stars\nIf you add `?extended=guest_stars` to the URL, it will return all guest stars that appeared in the episode.\n\n> ### Note\n> _This returns a lot of data, so please only use this extended parameter if you actually need it!_\n\n#### Markdown\nIf you add `?extended=markdown` to the URL, person biographies include links to the movies and shows they mention. Without it the biography is plain text.","summary":"Get all people for an episode","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"guest_stars":{"type":"array","items":{"type":"object","properties":{"episode_count":{"type":"integer","nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["person","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]},"episode_count":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}}},"required":["headshot"],"nullable":true},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["person","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodePeople"}},"/shows/{id}/seasons/{season}/episodes/{episode}/lists/{type}/{sort}":{"get":{"description":"#### 📄 Pagination 😁 Emojis\n\nReturns all lists that contain this episode. By default, `personal` lists are returned sorted by the most `popular`.","summary":"Get lists containing this episode","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["popular","likes","comments","items","added","updated"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","personal","official","watchlist","favorites"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeLists"}},"/shows/{id}/seasons/{season}/episodes/{episode}/videos":{"get":{"description":"#### ✨ Extended Info\nReturns all videos including trailers, teasers, clips, and featurettes.","summary":"Get all videos","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"site":{"type":"string"},"type":{"type":"string"},"size":{"type":"integer"},"official":{"type":"boolean"},"published_at":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"}},"required":["title","url","site","type","size","official","published_at","country","language"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeVideos"}},"/shows/{id}/seasons/{season}/episodes/{episode}/watchnow/{country}":{"get":{"description":"#### 🫣 Limited Access ✨ Extended Info\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns streaming and watch now sources for an episode in the requested country. Use `links` to include provider links when available.","summary":"Get episode watch now sources","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"2 character country code."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"},{"name":"links","in":"query","schema":{"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"cable":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"free":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"cinema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"subscription":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"purchase":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"streaming_ranks":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"delta":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true}},"required":["cable","free","cinema","subscription","purchase"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsEpisodeWatchnow"}},"/shows/{id}/seasons/{season}/episodes/{episode}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport an episode for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per episode.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another episode on Trakt |\n| `remove` | Should be removed from Trakt |\n| `data_refresh` | Request a full metadata refresh |\n| `metadata` | Metadata is wrong (title, overview, etc) |\n| `adult` | Marked as adult when it shouldn't be (or vice versa) |\n| `runtime` | Runtime is incorrect |\n| `language` | Not in English |\n| `spam` | Spam or fake episode |\n| `tmdb` | Should use TMDB as the datasource |\n| `other` | Anything else (add details in `message`) |","summary":"Report an episode","tags":["shows","episode"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Season number"},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Episode number"}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postShowsEpisodeReport"}},"/shows/trending":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most watched shows over the last 24 hours. Shows with the most `watchers` are returned first.","summary":"Get trending shows","tags":["shows"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watchers":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watchers","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsTrending"}},"/shows/watched/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most watched (unique users) shows in the specified time `period`, defaulting to `weekly`. All stats are relative to the specific time `period`.","summary":"Get the most watched shows","tags":["shows"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"collector_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","collector_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsWatched"}},"/shows/favorited/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most favorited shows in the specified time `period`, defaulting to `weekly`.","summary":"Get the most favorited shows","tags":["shows"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"user_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["user_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsFavorited"}},"/shows/played/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most played shows in the specified time `period`, defaulting to `weekly`.","summary":"Get the most played shows","tags":["shows"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"collector_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","collector_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsPlayed"}},"/shows/collected/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most collected shows in the specified time `period`, defaulting to `weekly`.","summary":"Get the most collected shows","tags":["shows"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly","yearly","all"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"watcher_count":{"type":"integer"},"play_count":{"type":"integer"},"collected_count":{"type":"integer"},"collector_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["watcher_count","play_count","collected_count","collector_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsCollected"}},"/shows/updates/{start_date}":{"get":{"description":"Returns all shows updated since the specified UTC date. We recommend storing the latest `updated_at` locally and using it for the next request.","summary":"Get recently updated shows","tags":["shows"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"updated_at":{"type":"string"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["updated_at","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsUpdates"}},"/shows/updates/id/{start_date}":{"get":{"description":"Returns Trakt IDs for shows updated since the specified UTC date.","summary":"Get recently updated show Trakt IDs","tags":["shows"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"integer"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsUpdatedIds"}},"/shows/anticipated":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most anticipated shows based on the number of lists a show appears on.","summary":"Get the most anticipated shows","tags":["shows"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"list_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["list_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsAnticipated"}},"/shows/hot":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns shows that are currently hot on Trakt. Results can be filtered by media fields or ignored user state.","summary":"Get hot shows","tags":["shows"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"list_count":{"type":"integer"},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["list_count","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsHot"}},"/shows/popular":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\n\nReturns the most popular shows. Popularity is calculated using the rating percentage and the number of ratings.","summary":"Get popular shows","tags":["shows"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"theme","in":"query","description":"Apply a seasonal theme such as `halloween` or `christmas`. The server expands it into the filters for the feed and the media type, and any filter you send yourself takes priority. Unknown themes are ignored.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsPopular"}},"/shows/streaming/{period}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters\nReturns shows recently available on streaming services for the requested `period`. Results can be filtered by media fields or ignored user state.","summary":"Get streaming shows","tags":["shows"],"parameters":[{"name":"period","in":"path","required":true,"schema":{"type":"string","enum":["daily","weekly","monthly"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"delta":{"type":"integer","nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getShowsStreaming"}},"/search/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\n\nSearch all text fields that a media object contains (i.e. title, overview, etc). Results are ordered by the most relevant score. Specify the `type` of results by sending a single value or a comma delimited string for multiple types.\n\n#### Special Characters\n\nOur search engine gives the following characters special meaning when they appear in a query:\n\n`+ - && || ! ( ) { } [ ] ^ \" ~ * ? : /`\n\nTo interpret any of these characters literally (and not as a special character), precede the character with a backslash `\\` character.\n\n#### Markdown\n\nIf you add `?extended=markdown` to a `person` search, the `biography` includes links to the movies and shows it mentions. Without it the biography is plain text.\n\n#### Search Fields\n\nBy default, certain text fields are used to search for the `query`. You can optionally specify the `fields` parameter with a single value or comma delimited string for multiple fields. Each `type` has specific `fields` that can be specified. This can be useful if you want to support more strict searches (i.e. title only).\n\n| Type | Field | Default |\n|---|---|---|\n| `movie` | `title` | ✓ |\n| | `original_title` | ✓ |\n| | `translations` | ✓ |\n| | `aliases` | ✓ |\n| | `tagline` | |\n| | `overview` | |\n| | `people` | |\n| `show` | `title` | ✓ |\n| | `original_title` | ✓ |\n| | `translations` | ✓ |\n| | `aliases` | ✓ |\n| | `overview` | |\n| | `people` | |\n| `episode` | `title` | ✓ |\n| | `show_title` | ✓ |\n| | `overview` | |\n| `person` | `name` | ✓ |\n| | `biography` | |\n| `list` | `name` | ✓ |\n| | `description` | ✓ |","summary":"Get text query results","tags":["search"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"nullable":true,"enum":["movie","show","episode","person","list"]},"description":"Specify the type of results by sending a single value or a comma delimited string for multiple types."},{"name":"query","in":"query","description":"The search query to search all text based fields.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"score":{"type":"number","format":"int64"},"type":{"type":"string","enum":["movie","show","episode","person","list"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"],"nullable":true},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"],"nullable":true}},"required":["score","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSearchQuery"}},"/search/{type}/exact":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\nSearch for exact movie or show matches using the requested search `type` and `query`. Results are paginated and can include extended media details.","summary":"Get exact text query results","tags":["search"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"nullable":true,"enum":["movie","show"]},"description":"Specify the type of results by sending a single value or a comma delimited string for multiple types."},{"name":"query","in":"query","description":"The search query to search all text based fields.","schema":{"type":"string","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"score":{"type":"number","format":"int64"},"type":{"type":"string","enum":["movie","show","episode","person","list"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"],"nullable":true},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"],"nullable":true}},"required":["score","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSearchExact"}},"/search/{id_type}/{id}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\nLookup items by external ID. Use `id_type` and `id` to identify the external ID, and optionally send `type` to limit the result media type.","summary":"Get ID lookup results","tags":["search"],"parameters":[{"name":"id_type","in":"path","required":true,"schema":{"type":"string"},"description":"External ID type to look up."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"External ID value."},{"name":"type","in":"query","description":"Optional media type filter.","schema":{"type":"string"}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"score":{"type":"number","format":"int64"},"type":{"type":"string","enum":["movie","show","episode","person","list"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"],"nullable":true},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"],"nullable":true}},"required":["score","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSearchLookup"}},"/search/recent_by_id/global/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\nReturns globally trending recent searches by `type`. Use `query` to narrow the search text and pagination to move through the result set.","summary":"Get trending search results","tags":["search"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"nullable":true,"enum":["movies","shows","people"]},"description":"Specify the type of results by sending a single value or a comma delimited string for multiple types."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"query","in":"query","description":"The search query to search all text based fields.","schema":{"type":"string","nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"count":{"type":"integer"},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","count","type"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"count":{"type":"integer"},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","count","type"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"count":{"type":"integer"},"type":{"type":"string","enum":["person"]},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"],"nullable":true}},"required":["id","count","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSearchTrending"}},"/search/recent/":{"post":{"description":"#### 🔒 OAuth Required\nAdd a recent search to the global search trends. This is not a user-specific recent search history. Send the search request body; a successful create returns `201` with no response body.","summary":"Add recent search","tags":["search","recent"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"id":{"type":"integer"},"type":{"type":"string","enum":["movies","shows","people","lists"]}},"required":["query","id","type"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postSearchRecentAdd"}},"/people/updates/{start_date}":{"get":{"description":"Returns all people updated since the specified UTC date. We recommend storing the latest `updated_at` locally and using it for the next request.","summary":"Get recently updated people","tags":["people"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"updated_at":{"type":"string"},"person":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]}},"required":["updated_at","person"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleUpdates"}},"/people/updates/id/{start_date}":{"get":{"description":"Returns Trakt IDs for people updated since the specified UTC date.","summary":"Get recently updated people Trakt IDs","tags":["people"],"parameters":[{"name":"start_date","in":"path","required":true,"schema":{"type":"string"},"description":"UTC date to start checking for updates."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"integer"}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleUpdatedIds"}},"/people/{id}/":{"get":{"description":"#### ✨ Extended Info\nReturns a single person's details.\n\n#### Gender\nIf available, the `gender` property will be set to `male`, `female`, or `non_binary`.\n\n#### Known For Department\nIf available, the `known_for_department` property will be set to `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, or `editing`. Many people have credits across departments, `known_for` allows you to select their default credits more accurately.\n\n#### Biography\nThe `biography` is plain text. Request extended `markdown` to get markdown links to the movies and shows it mentions.\n\n#### Social IDs\nWith extended `full`, `social_ids` includes `twitter`, `facebook`, `instagram`, `tiktok`, `youtube`, `wikidata` and `wikipedia`. `wikipedia_language` is the language of the `wikipedia` page. Pass `language` to pick the page language, it falls back to the base language, then English. A malformed `language` returns a `400`.","summary":"Get a single person","tags":["people"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"language","in":"query","description":"Language code to pick the Wikipedia page in, like `pt` or `pt-br`. Falls back to the base language, then English.","schema":{"type":"string","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"object","properties":{"slug":{"type":"string"},"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["slug","trakt"]},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true},"tiktok":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true},"wikidata":{"type":"string","nullable":true},"wikipedia_language":{"type":"string","nullable":true}},"nullable":true},"biography":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"birthday":{"type":"string","nullable":true},"height":{"type":"number","format":"float","nullable":true},"death":{"type":"string","nullable":true},"birthplace":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"known_for_department":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"images":{"type":"object","properties":{"headshot":{"type":"array","items":{"type":"string"}},"fanart":{"type":"array","items":{"type":"string"}}},"required":["headshot","fanart"],"nullable":true}},"required":["name","ids"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleSummary"}},"/people/{id}/movies":{"get":{"description":"#### ✨ Extended Info\nReturns all movies where this person is in the `cast` or `crew`. Each `cast` object will have a `characters` array and a standard `movie` object.\n\nThe `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, and `editing` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `movie` object.","summary":"Get movie credits","tags":["people"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["movie","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["movie","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleMovies"}},"/people/{id}/shows":{"get":{"description":"#### ✨ Extended Info\nReturns all shows where this person is in the `cast` or `crew`, including the `episode_count` for which they appear. Each `cast` object will have a `characters` array and a standard `show` object. If `series_regular` is `true`, this person is a series regular and not simply a guest star.\n\nThe `crew` object will be broken up by department into `production`, `art`, `crew`, `costume & make-up`, `directing`, `writing`, `sound`, `camera`, `visual effects`, `lighting`, `editing`, and `created by` (if there are people for those crew positions). Each of those members will have a `jobs` array and a standard `show` object.","summary":"Get show credits","tags":["people"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"cast":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"episode_count":{"type":"integer","nullable":true},"series_regular":{"type":"boolean"},"character":{"type":"string"},"characters":{"type":"array","items":{"type":"string"}}},"required":["show","series_regular","character","characters"]},"nullable":true},"crew":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},"episode_count":{"type":"integer","nullable":true},"job":{"type":"string"},"jobs":{"type":"array","items":{"type":"string"}}},"required":["show","job","jobs"]}},"nullable":true}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleShows"}},"/people/{id}/lists/{type}/{sort}":{"get":{"description":"#### 📄 Pagination 😁 Emojis\n\nLists no longer support people, so this always returns an empty array.","summary":"Get lists containing this person","deprecated":true,"tags":["people"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string","enum":["popular","likes","comments","items","added","updated"]}},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["all","personal","official","watchlist","favorites"]}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getPeopleLists"}},"/people/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a person for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per person.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another person on Trakt |\n| `remove` | Should be removed from Trakt |\n| `data_refresh` | Request a full metadata refresh |\n| `metadata` | Metadata is wrong (name, biography, etc) |\n| `adult` | Marked as adult when it shouldn't be (or vice versa) |\n| `language` | Not in English |\n| `spam` | Spam or fake person |\n| `tmdb` | Should use TMDB as the datasource |\n| `other` | Anything else (add details in `message`) |","summary":"Report a person","tags":["people"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postPeopleReport"}},"/watchnow/sources":{"get":{"description":"#### 🫣 Limited Access\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns all watch now sources supported by Trakt, including provider metadata used by watch now routes.","summary":"Get watch now sources","tags":["watchnow","sources"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["free","tv_everywhere","subscription","purchase","cinema"],"nullable":true},"free":{"type":"boolean"},"cinema":{"type":"boolean"},"amazon":{"type":"boolean"},"color":{"type":"string"},"link_count":{"type":"integer"},"images":{"type":"object","properties":{"logo":{"type":"string","nullable":true},"channel":{"type":"string","nullable":true}}}},"required":["source","name","free","cinema","amazon","color","link_count","images"]}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getWatchnowSourcesAll"}},"/watchnow/sources/{countryCode}":{"get":{"description":"#### 🫣 Limited Access\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns watch now sources available in a country. Use the `countryCode` path parameter to request country-specific provider metadata.","summary":"Get watch now sources by country","tags":["watchnow","sources"],"parameters":[{"name":"countryCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["free","tv_everywhere","subscription","purchase","cinema"],"nullable":true},"free":{"type":"boolean"},"cinema":{"type":"boolean"},"amazon":{"type":"boolean"},"color":{"type":"string"},"link_count":{"type":"integer"},"images":{"type":"object","properties":{"logo":{"type":"string","nullable":true},"channel":{"type":"string","nullable":true}}}},"required":["source","name","free","cinema","amazon","color","link_count","images"]}}}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getWatchnowSourcesCountry"}},"/seasons/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a season for moderator review. Send a reason and optional message in the request body; duplicate pending reports return `409`.","summary":"Report a season","tags":["seasons"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postSeasonsReport"}},"/episodes/{id}/watchnow/{country}":{"get":{"description":"#### 🫣 Limited Access ✨ Extended Info\nThis endpoint is documented for visibility, but access is currently limited and may not be available to all API consumers.\n\nReturns streaming and watch now sources for an episode in the requested country. Use `links` to include provider links when available.","summary":"Get episode watch now sources","tags":["episodes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"integer"}]},"description":"The Trakt ID of the resource to get the watch now sources of."},{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"2 character country code."},{"name":"links","in":"query","schema":{"nullable":true}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","properties":{"cable":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"free":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"cinema":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"subscription":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"purchase":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"link":{"type":"string"},"uhd":{"type":"boolean"},"currency":{"type":"string","nullable":true},"prices":{"type":"object","properties":{"rent":{"type":"string","nullable":true},"purchase":{"type":"string","nullable":true}}},"link_tvos":{"type":"string","nullable":true},"link_direct":{"type":"string","nullable":true},"link_android":{"type":"string","nullable":true},"link_webos":{"type":"object","properties":{"id":{"type":"string"},"params":{"type":"object","properties":{"contentTarget":{"type":"string"}},"required":["contentTarget"]}},"required":["id","params"],"nullable":true}},"required":["source","link","uhd","prices"]}},"streaming_ranks":{"type":"object","properties":{"rank":{"type":"integer","nullable":true},"delta":{"type":"integer","nullable":true},"link":{"type":"string","nullable":true}},"nullable":true}},"required":["cable","free","cinema","subscription","purchase"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getEpisodesWatchnow"}},"/episodes/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport an episode for moderator review. Send a reason and optional message in the request body; duplicate pending reports return `409`.","summary":"Report an episode","tags":["episodes"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","data_refresh","metadata","adult","runtime","language","spam","tmdb","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postEpisodesReport"}},"/lists/trending":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns trending lists ordered by current activity. Use pagination and filters to control the result set.","summary":"Get trending lists","tags":["lists"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"like_count":{"type":"integer"},"comment_count":{"type":"integer"},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}},"required":["like_count","comment_count","list"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsTrending"}},"/lists/trending/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns trending lists ordered by current activity. Use `type`, pagination, and filters to control the result set.","summary":"Get trending lists","tags":["lists"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"List type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"like_count":{"type":"integer"},"comment_count":{"type":"integer"},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}},"required":["like_count","comment_count","list"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsTrendingByType"}},"/lists/popular":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns popular lists ordered by long-term activity. Use pagination and filters to control the result set.","summary":"Get popular lists","tags":["lists"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"like_count":{"type":"integer"},"comment_count":{"type":"integer"},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}},"required":["like_count","comment_count","list"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsPopular"}},"/lists/popular/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns popular lists ordered by long-term activity. Use `type`, pagination, and filters to control the result set.","summary":"Get popular lists","tags":["lists"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"List type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"like_count":{"type":"integer"},"comment_count":{"type":"integer"},"list":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}},"required":["like_count","comment_count","list"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsPopularByType"}},"/lists/{id}":{"get":{"description":"#### 😁 Emojis\nReturns a single list. Use the [**/lists/:id/items**](#reference/lists/list-items) method to get the actual items this list contains.\n\n> ### Note\n> _You must use an integer `id`, and only public lists will return data._","summary":"Get list","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsSummary"}},"/lists/{id}/items/movie":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns movie items on a public list. Use `id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get movie list items","tags":["lists","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","movie"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsItemsMovie"}},"/lists/{id}/items/show":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns show items on a public list. Use `id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get show list items","tags":["lists","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]}},"required":["rank","id","listed_at","type","show"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsItemsShow"}},"/lists/{id}/items/movie,show":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns movie and show items on a public list. Use `id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get media list items","tags":["lists","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsItemsMedia"}},"/lists/{id}/items/movie,show,episode,season":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns movie, show, episode, and season items on a public list. Use `id` to identify the list and query sorting, filters, and pagination to control the result set.","summary":"Get all list items","tags":["lists","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"sort_by","in":"query","description":"The field to sort by","schema":{"type":"string","nullable":true}},{"name":"sort_how","in":"query","description":"The direction to sort in","schema":{"type":"string","enum":["asc","desc"],"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsItemsAll"}},"/lists/{id}/items/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔥 VIP Enhanced 📄 Pagination Optional ✨ Extended Info 😁 Emojis\nGet all items on a personal list. Items can be a `movie`, `show`, `season`, or `episode`. You can optionally specify the `type` parameter with a single value or comma delimited string for multiple item types.","summary":"Get items on a list","tags":["lists","items"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"List item type filter."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"Sort by a specific property."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"Sort direction."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Use \"favorites\" for streaming on a favorite service of the user.\n Use \"any\" for streaming on any service in the user's country.\n Use \"any_all\" for streaming on any service in all countries.\n Use \"free\" for streaming for free in the user's country.\n Use \"free_all\" for streaming for free in all countries.\n Use \"subscriptions\" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.\n Use \"subscriptions_all\" streaming on any subscription service in all countries","schema":{"type":"string","enum":["favorites","any","any_all","free","free_all","subscriptions","subscriptions_all"],"nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"start_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"end_date","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string","nullable":true}},{"name":"parental_include_unrated","in":"query","description":"Also include titles without parental guide ratings.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_collected","in":"query","description":"Ignore collected items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["movie"]},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["show"]},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["season"]},"season":{"type":"object","properties":{"number":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"tmdb":{"type":"integer","nullable":true}},"required":["trakt"]},"aired_episodes":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"episode_count":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string"},"updated_at":{"type":"string","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"network":{"type":"string","nullable":true},"images":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["poster","thumb"],"nullable":true}},"required":["number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]},{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"integer"},"listed_at":{"type":"string"},"notes":{"type":"string","nullable":true},"type":{"type":"string","enum":["episode"]},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","id","listed_at","type"]}]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsItemsTypedSorted"}},"/lists/{id}/comments/{sort}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all top level comments for a list. By default, comments are sorted by most `likes`. Other sorting options include `likes_30`, most `replies`, `replies_30`, most `plays`, highest `rating`, and `added` date.\n\n> ### Note\n> _If you send OAuth, comments from blocked users will be automatically filtered out._","summary":"Get all list comments","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"sort","in":"path","required":true,"schema":{"type":"string"},"description":"Comment sort option."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsComments"}},"/lists/{id}/likes":{"get":{"description":"#### 📄 Pagination\nReturns all users who liked a list.","summary":"Get all users who liked a list","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"liked_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["liked_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getListsLikes"}},"/lists/{id}/like":{"post":{"description":"#### 🔒 OAuth Required\nVotes help determine popular lists. Only one like is allowed per list per user.","summary":"Like a list","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postListsLike"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a like on a list.","summary":"Remove like on a list","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteListsUnlike"}},"/lists/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a list for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per list.\n\n| reason | description |\n|---|---|\n| `duplicate` | Duplicate of another list |\n| `remove` | Should be removed from Trakt |\n| `metadata` | Metadata is wrong (name, description, etc) |\n| `adult` | Contains adult content |\n| `language` | Not in English |\n| `spam` | Spam or self-promotion |\n| `other` | Anything else (add details in `message`) |","summary":"Report a list","tags":["lists"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["duplicate","remove","metadata","adult","language","spam","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postListsReport"}},"/smart-lists/{list_id}":{"get":{"description":"#### 🔓 OAuth Optional 😁 Emojis\nReturns a single smart list definition by its globally-unique slug. Use the [**/smart-lists/:list_id/items**](#reference/smart-lists) method to get the dynamic items this smart list resolves to.\n\n> ### Note\n> _Only public smart lists return data unless you send OAuth as the owner._","summary":"Get smart list","tags":["smart_lists"],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"privacy":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"]},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}}},"required":["name","privacy","created_at","updated_at","ids","images","source","media_type","filters"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSmart_listsSummary"}},"/smart-lists/{list_id}/items":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns the dynamic items a smart list resolves to, worked out when you request them. A list can hold movies, shows, or both. Use query filters and pagination to refine the result set.\n\nQuery filters narrow the list: they apply on top of its own filters, never instead of them. A thriller list requested with `genres=crime` returns thrillers that are also crime. `ignore_*` flags add to the list's own, and the list's source and streaming region always stay its own.\n\nStreaming (`watchnow`) filters resolve against the list owner, not the caller: the list region, else the owner's region, else `us`, and `favorites` means the owner's services.\n\nList filters (`genres`, `studios`, `people`, `watchnow`, and similar) accept a `-` prefix on a value to exclude it. New filters: `released_within_days`, `tmdb_ratings`, `metascores`, `votes`, `imdb_votes`, `studios`, `people`, `people_operator` and `people_role`.","summary":"Get smart list items","tags":["smart_lists"],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Streaming filter. `favorites` for services of the list owner, `any` for any service in the list region, `free` for free streaming, `subscriptions` for subscription services, or a service name such as `netflix`. Prefix a value with `-` to exclude it, e.g. `-netflix`.","schema":{"type":"string","nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_include_unrated","in":"query","description":"Keep titles without a parental guide when a parental range is set. Defaults to `false`.","schema":{"type":"boolean"}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"released_within_days","in":"query","description":"Only titles released within the last N days, from 1 to 3650. Movies use the release date, shows the first aired date.","schema":{"type":"integer","minimum":1,"maximum":3650}},{"name":"tmdb_ratings","in":"query","description":"TMDB rating, 0 to 10, range `min-max`, either side optional, e.g. `7.5-10`.","schema":{"type":"string"}},{"name":"metascores","in":"query","description":"Metascore, 0 to 100, range `min-max`, either side optional, e.g. `70-100`.","schema":{"type":"string"}},{"name":"votes","in":"query","description":"Trakt vote count range `min-max`, either side optional, e.g. `1000-`.","schema":{"type":"string"}},{"name":"imdb_votes","in":"query","description":"IMDb vote count range `min-max`, either side optional, e.g. `5000-`.","schema":{"type":"string"}},{"name":"studios","in":"query","description":"Comma-separated production company slugs or names. Prefix with `-` to exclude, e.g. `pixar,-dreamworks-animation`.","schema":{"type":"string"}},{"name":"people","in":"query","description":"Comma-separated person slugs. Prefix with `-` to exclude, e.g. `steven-spielberg`.","schema":{"type":"string"}},{"name":"people_operator","in":"query","description":"Whether titles must include every listed person (`and`) or any of them (`or`). Defaults to `or`.","schema":{"type":"string","enum":["and","or"]}},{"name":"people_role","in":"query","description":"Restrict `people` matches to a role. Defaults to `any`.","schema":{"type":"string","enum":["any","cast","directing","writing","producing"]}},{"name":"watchnow_country","in":"query","description":"Two-letter region for `watchnow`. Defaults to the list region, then the owner region, then `us`.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"type":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSmart_listsItems"}},"/smart-lists/templates":{"get":{"description":"#### 🔓 OAuth Optional ✨ Extended Info 😁 Emojis\nReturns the official smart list templates in display order. Each template has a stable `id`, a `source`, a `media_type` and the same `filters` a saved smart list returns, so a client can create a smart list from it as is.\n\nTemplates whose results depend on the viewer have `personal: true`, `total: null` and no `items`. Load their items with `/smart-lists/preview/items` while signed in. The other templates return their `total` and up to 3 `items`. Use `extended=images` to include posters.","summary":"Get smart list templates","tags":["smart_lists"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"media_type":{"type":"string"},"filters":{"type":"object","properties":{"genres":{"type":"array","items":{"type":"string"}},"genres_operator":{"type":"string","enum":["and","or"]},"subgenres":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}},"keywords_operator":{"type":"string","enum":["and","or"]},"studios":{"type":"array","items":{"type":"string"}},"people":{"type":"array","items":{"type":"string"}},"people_operator":{"type":"string","enum":["and","or"]},"people_role":{"type":"string","enum":["any","cast","directing","writing","producing"]},"watchnow":{"type":"array","items":{"type":"string"}},"watchnow_country":{"type":"string","pattern":"^[a-z]{2}$"},"years":{"type":"array","items":{"type":"integer"},"maxItems":2},"released_within_days":{"type":"integer","minimum":1,"maximum":3650},"ratings":{"type":"array","items":{"type":"integer"},"maxItems":2},"runtimes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"tmdb_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"metascores":{"type":"array","items":{"type":"integer"},"maxItems":2},"votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"imdb_votes":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"rt_user_meters":{"type":"array","items":{"type":"integer"},"maxItems":2},"letterboxd_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"mal_ratings":{"type":"array","items":{"type":"number","format":"float"},"maxItems":2},"parental_nudity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_violence":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_profanity":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_alcohol":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_frightening":{"type":"array","items":{"type":"integer","minimum":0,"maximum":3},"maxItems":2},"parental_include_unrated":{"type":"boolean"},"ignore_watched":{"type":"boolean"},"ignore_watchlisted":{"type":"boolean"},"ignore_watching":{"type":"boolean"},"ignore_unreleased":{"type":"boolean"},"ignore_released":{"type":"boolean"},"ignore_ended":{"type":"boolean"},"ignore_airing":{"type":"boolean"},"ignore_no_release_date":{"type":"boolean"}}},"personal":{"type":"boolean"},"total":{"type":"integer","nullable":true},"items":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"type":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","type"]}}},"required":["id","source","media_type","filters","personal","items"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSmart_listsTemplates"}},"/smart-lists/{list_id}/items/{type}/{sort_by}/{sort_how}":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters 😁 Emojis\nReturns the dynamic items a smart list resolves to, worked out when you request them. A list can hold movies, shows, or both. Use query filters and pagination to refine the result set.\n\nQuery filters narrow the list: they apply on top of its own filters, never instead of them. A thriller list requested with `genres=crime` returns thrillers that are also crime. `ignore_*` flags add to the list's own, and the list's source and streaming region always stay its own.\n\nStreaming (`watchnow`) filters resolve against the list owner, not the caller: the list region, else the owner's region, else `us`, and `favorites` means the owner's services.\n\nList filters (`genres`, `studios`, `people`, `watchnow`, and similar) accept a `-` prefix on a value to exclude it. New filters: `released_within_days`, `tmdb_ratings`, `metascores`, `votes`, `imdb_votes`, `studios`, `people`, `people_operator` and `people_role`.\n\nUse `type` to narrow a list holding both media types, and `sort_by` / `sort_how` to reorder it. A sorted list holding both media types is merged into one order across pages.","summary":"Get smart list items by type and sort","tags":["smart_lists"],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"`all`, `movies` or `shows`. Narrows a list holding both media types."},{"name":"sort_by","in":"path","required":true,"schema":{"type":"string"},"description":"`rank` (default, the source order), `random`, `title`, `released`, `runtime`, `percentage`, `votes`, `imdb_rating`, `imdb_votes`, `tmdb_rating`, `tmdb_votes`, `rt_tomatometer`, `rt_audience`, `metascore`. Watchlist lists also take `added`. Recommendation lists always use `rank`. Unknown values fall back to `rank`."},{"name":"sort_how","in":"path","required":true,"schema":{"type":"string"},"description":"`asc` or `desc`. Defaults to `asc` for `rank` and `title`, `desc` otherwise."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"watchnow","in":"query","description":"Streaming filter. `favorites` for services of the list owner, `any` for any service in the list region, `free` for free streaming, `subscriptions` for subscription services, or a service name such as `netflix`. Prefix a value with `-` to exclude it, e.g. `-netflix`.","schema":{"type":"string","nullable":true}},{"name":"genres","in":"query","schema":{"type":"string","nullable":true}},{"name":"subgenres","in":"query","schema":{"type":"string","nullable":true}},{"name":"years","in":"query","schema":{"type":"string","nullable":true}},{"name":"ratings","in":"query","schema":{"type":"string","nullable":true}},{"name":"runtimes","in":"query","schema":{"type":"string","nullable":true}},{"name":"countries","in":"query","schema":{"type":"string","nullable":true}},{"name":"statuses","in":"query","schema":{"type":"string","nullable":true}},{"name":"certifications","in":"query","schema":{"type":"string","nullable":true}},{"name":"parental_nudity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_violence","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_profanity","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_alcohol","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_frightening","in":"query","description":"Parental guide severity range `min-max`, from 0 (none) to 3 (severe).","schema":{"type":"string"}},{"name":"parental_include_unrated","in":"query","description":"Keep titles without a parental guide when a parental range is set. Defaults to `false`.","schema":{"type":"boolean"}},{"name":"ignore_watched","in":"query","description":"Ignore watched items.","schema":{"type":"boolean","nullable":true}},{"name":"ignore_watchlisted","in":"query","description":"Ignore watchlisted items.","schema":{"type":"boolean","nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"released_within_days","in":"query","description":"Only titles released within the last N days, from 1 to 3650. Movies use the release date, shows the first aired date.","schema":{"type":"integer","minimum":1,"maximum":3650}},{"name":"tmdb_ratings","in":"query","description":"TMDB rating, 0 to 10, range `min-max`, either side optional, e.g. `7.5-10`.","schema":{"type":"string"}},{"name":"metascores","in":"query","description":"Metascore, 0 to 100, range `min-max`, either side optional, e.g. `70-100`.","schema":{"type":"string"}},{"name":"votes","in":"query","description":"Trakt vote count range `min-max`, either side optional, e.g. `1000-`.","schema":{"type":"string"}},{"name":"imdb_votes","in":"query","description":"IMDb vote count range `min-max`, either side optional, e.g. `5000-`.","schema":{"type":"string"}},{"name":"studios","in":"query","description":"Comma-separated production company slugs or names. Prefix with `-` to exclude, e.g. `pixar,-dreamworks-animation`.","schema":{"type":"string"}},{"name":"people","in":"query","description":"Comma-separated person slugs. Prefix with `-` to exclude, e.g. `steven-spielberg`.","schema":{"type":"string"}},{"name":"people_operator","in":"query","description":"Whether titles must include every listed person (`and`) or any of them (`or`). Defaults to `or`.","schema":{"type":"string","enum":["and","or"]}},{"name":"people_role","in":"query","description":"Restrict `people` matches to a role. Defaults to `any`.","schema":{"type":"string","enum":["any","cast","directing","writing","producing"]}},{"name":"watchnow_country","in":"query","description":"Two-letter region for `watchnow`. Defaults to the list region, then the owner region, then `us`.","schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"type":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["rank","type"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getSmart_listsTypedSorted"}},"/comments/{id}":{"get":{"description":"#### 😁 Emojis\nReturns a single comment and indicates how many replies it has. Use [**/comments/:id/replies**](/reference/comments/replies/) to get the actual replies.","summary":"Get a comment or reply","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsSummary"}},"/comments/{id}/item":{"get":{"description":"#### ✨ Extended Info\nReturns the media item this comment is attached to. The media type can be `movie`, `show`, `season`, `episode`, or `list` and it also returns the standard media object for that media type.","summary":"Get the attached media item","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"]},{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"]},{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string","nullable":true},"privacy":{"type":"string"},"share_link":{"type":"string"},"type":{"type":"string"},"display_numbers":{"type":"boolean"},"allow_comments":{"type":"boolean"},"sort_by":{"type":"string"},"sort_how":{"type":"string","enum":["asc","desc"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"item_count":{"type":"integer"},"comment_count":{"type":"integer"},"likes":{"type":"integer"},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]},"stale_origin":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["name","url"],"nullable":true},"converted_to":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"}},"required":["trakt","slug"]}},"required":["ids"],"nullable":true},"images":{"type":"object","properties":{"posters":{"type":"array","items":{"type":"string"}}},"required":["posters"],"nullable":true}},"required":["name","privacy","share_link","type","display_numbers","allow_comments","sort_by","sort_how","created_at","updated_at","item_count","comment_count","likes","ids","user"]}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsItem"}},"/comments/{id}/likes":{"get":{"description":"#### 📄 Pagination\nReturns all users who liked a comment. If you only need the `replies` count, the main `comment` object already has that, so no need to use this method.","summary":"Get all users who liked a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"liked_at":{"type":"string"},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["liked_at","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsLikes"}},"/comments/{id}/like":{"post":{"description":"#### 🔒 OAuth Required\nVotes help determine popular comments. Only one like is allowed per comment per user.","summary":"Like a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postCommentsLike"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a like on a comment.","summary":"Remove like on a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteCommentsUnlike"}},"/comments/{id}/report":{"post":{"description":"#### 🔒 OAuth Required\nReport a comment for moderator review. Send a `reason` and optional `message` with additional context. A user can only have one `pending` report per comment.\n\n| reason | description |\n|---|---|\n| `spoilers` | Contains spoilers |\n| `language` | Not in English |\n| `abusive` | Harassment or abusive behavior |\n| `spam` | Spam or self-promotion |\n| `bigotry` | Bigotry, hate speech, or discrimination |\n| `political` | Political attack |\n| `offtopic` | Off topic |\n| `support` | Support question |\n| `duplicate` | Duplicate comment |\n| `too_short` | Too short to be useful |\n| `other` | Anything else (add details in `message`) |","summary":"Report a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","enum":["spoilers","language","abusive","spam","bigotry","political","offtopic","support","duplicate","too_short","other"],"description":"Reason this item is being reported for moderator review."},"message":{"type":"string","description":"Optional additional context for the report."}},"required":["reason"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"409":{"description":"409","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postCommentsReport"}},"/comments/{id}/replies":{"get":{"description":"#### 🔓 OAuth Optional 📄 Pagination 😁 Emojis\n\nReturns all replies for a comment. It is possible these replies could have replies themselves, so in that case you would just call [**/comments/:id/replies**](/reference/comments/replies/) again with the new comment `id`.\n\n> ### Note\n> _If you send OAuth, replies from blocked users will be automatically filtered out._","summary":"Get replies for a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.","schema":{"type":"integer","nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsReplies"},"post":{"description":"#### 🔒 OAuth Required 😁 Emojis\nAdd a new reply to an existing comment. Make sure to allow and encourage *spoilers* to be indicated in your app and follow the rules listed above.\n\n> ### Note\n> Replies can only be added to top level comments. If you try to reply to a reply, a `404` HTTP status code is returned.\n\n#### JSON POST Data\n| Key | Type | Default | Value |\n|---|---|---|---|\n| `comment` * | string | | Text for the reply. |\n| `spoiler` | boolean | `false` | Is this a spoiler? |\n| `gif` | object | | Klipy GIF to attach. A GIF on its own is a valid comment. (see below ↓) |\n\n#### GIF\nSend `null` to remove the GIF.\n\n| Key | Type | Value |\n|---|---|---|\n| `url` * | string | Klipy GIF url. |\n| `slug` | string | Klipy GIF slug, up to 255 characters. |","summary":"Post a reply for a comment","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string"},"spoiler":{"type":"boolean"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true}},"required":["comment","spoiler"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postCommentsReply"}},"/comments/{id}/":{"put":{"description":"#### 🔒 OAuth Required 😁 Emojis\nUpdate a single comment. The OAuth user must match the author of the comment in order to update it. If not, a `401` HTTP status is returned.\n\n#### JSON POST Data\n| Key | Type | Default | Value |\n|---|---|---|---|\n| `comment` | string | | Text for the comment. |\n| `spoiler` | boolean | `false` | Is this a spoiler? |\n| `gif` | object | | Klipy GIF to attach. A GIF on its own is a valid comment. (see below ↓) |\n\n#### GIF\nSend `null` to remove the GIF.\n\n| Key | Type | Value |\n|---|---|---|\n| `url` * | string | Klipy GIF url. |\n| `slug` | string | Klipy GIF slug, up to 255 characters. |","summary":"Update a comment or reply","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string"},"spoiler":{"type":"boolean"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true}},"required":["comment","spoiler"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"putCommentsEdit"},"delete":{"description":"#### 🔒 OAuth Required\nDelete a single comment. The OAuth user must match the author of the comment in order to delete it. If not, a `401` HTTP status code is returned. The comment must also be less than 2 weeks old or have 0 replies. If not, a `409` HTTP status is returned.","summary":"Delete a comment or reply","tags":["comments"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id/slug of the resource."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteCommentsDelete"}},"/comments/{id}/reactions/summary":{"get":{"description":"Returns reaction totals for a comment, grouped by reaction type.","summary":"Get reaction summary","tags":["comments","reactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"reaction_count":{"type":"integer"},"user_count":{"type":"integer"},"distribution":{"type":"object","additionalProperties":{"type":"integer"}}},"required":["reaction_count","user_count","distribution"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsReactionsSummary"}},"/comments/{id}/reactions/":{"get":{"description":"#### 📄 Pagination ✨ Extended Info\nReturns users and reaction details for every reaction on a comment. Use pagination and `extended` to control the response.","summary":"Get comment reactions","tags":["comments","reactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"reacted_at":{"type":"string"},"reaction":{"type":"object","properties":{"type":{"type":"string","enum":["like","dislike","love","laugh","shocked","bravo","spoiler"]}},"required":["type"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["reacted_at","reaction","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsReactionsAll"}},"/comments/{id}/reactions/{reaction_type}":{"post":{"description":"#### 🔒 OAuth Required\nAdd a reaction to a comment. Use `reaction_type` to choose the reaction; a successful create returns `204` with no response body.","summary":"Add comment reaction","tags":["comments","reactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"reaction_type","in":"path","required":true,"schema":{"type":"string","enum":["like","dislike","love","laugh","shocked","bravo","spoiler"]}}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postCommentsReactionsAdd"},"delete":{"description":"#### 🔒 OAuth Required\nRemove a reaction from a comment. Use `reaction_type` to choose the reaction; a successful delete returns `204` with no response body.","summary":"Remove comment reaction","tags":["comments","reactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"reaction_type","in":"path","required":true,"schema":{"type":"string","enum":["like","dislike","love","laugh","shocked","bravo","spoiler"]}}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"deleteCommentsReactionsRemove"}},"/comments/trending/{comment_type}/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 😁 Emojis\nReturns all comments with the most likes and replies over the last 7 days. You can optionally filter by the `comment_type` and media `type` to limit what gets returned. If you want to `include_replies` that will return replies in place alongside top level comments.","summary":"Get trending comments","tags":["comments"],"parameters":[{"name":"comment_type","in":"path","required":true,"schema":{"type":"string"},"description":"Comment type filter."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"include_replies","in":"query","description":"Include replies inline alongside top level comments.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsTrending"}},"/comments/recent/{comment_type}/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 😁 Emojis\nReturns the most recently written comments across all of Trakt. You can optionally filter by the `comment_type` and media `type` to limit what gets returned. If you want to `include_replies` that will return replies in place alongside top level comments.","summary":"Get recently created comments","tags":["comments"],"parameters":[{"name":"comment_type","in":"path","required":true,"schema":{"type":"string"},"description":"Comment type filter."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"include_replies","in":"query","description":"Include replies inline alongside top level comments.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsRecent"}},"/comments/updates/{comment_type}/{type}":{"get":{"description":"#### 📄 Pagination ✨ Extended Info 😁 Emojis\nReturns the most recently updated comments across all of Trakt. You can optionally filter by the `comment_type` and media `type` to limit what gets returned. If you want to `include_replies` that will return replies in place alongside top level comments.","summary":"Get recently updated comments","tags":["comments"],"parameters":[{"name":"comment_type","in":"path","required":true,"schema":{"type":"string"},"description":"Comment type filter."},{"name":"type","in":"path","required":true,"schema":{"type":"string"},"description":"Media type filter."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}},{"name":"page","in":"query","description":"The page number to retrieve","schema":{"type":"integer","nullable":true}},{"name":"limit","in":"query","description":"The number of items per page, can be a number or the value all","schema":{"nullable":true,"type":"string"}},{"name":"include_replies","in":"query","description":"Include replies inline alongside top level comments.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCommentsUpdates"}},"/comments/":{"post":{"description":"#### 🔒 OAuth Required 😁 Emojis\nAdd a new comment to a movie, show, season, episode, or list. Make sure to allow and encourage *spoilers* to be indicated in your app and follow the rules listed above.\n\n#### JSON POST Data\n| Key | Type | Default | Value |\n|---|---|---|---|\n| item * | object | | `movie`, `show`, `season`, `episode`, or `list` object. (see examples ->) |\n| `comment` * | string | | Text for the comment. |\n| `spoiler` | boolean | `false` | Is this a spoiler? |\n| `gif` | object | | Klipy GIF to attach. A GIF on its own is a valid comment. (see below ↓) |\n| `sharing` | object | | Control sharing to any connected social networks. (see below ↓) |\n\n#### GIF\nSend `null` to remove the GIF.\n\n| Key | Type | Value |\n|---|---|---|\n| `url` * | string | Klipy GIF url. |\n| `slug` | string | Klipy GIF slug, up to 255 characters. |\n\n#### Sharing\nThe `sharing` object is optional and will apply the user's settings if not sent. If `sharing` is sent, each key will override the user's setting for that social network. Send `true` to post or `false` to not post on the indicated social network. You can see which social networks a user has connected with the [**/users/settings**](/reference/users/settings) method.\n\n| Key | Type |\n|---|---|\n| `twitter` | boolean |\n| `tumblr` | boolean |\n| `medium` | boolean |","summary":"Post a comment","tags":["comments"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"comment":{"type":"string"},"spoiler":{"type":"boolean"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true}},"required":["comment","spoiler"]},{"oneOf":[{"type":"object","properties":{"movie":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"}},"required":["trakt"]}},"required":["ids"],"nullable":true}}},{"type":"object","properties":{"show":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"}},"required":["trakt"]}},"required":["ids"],"nullable":true}}},{"type":"object","properties":{"season":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"}},"required":["trakt"]}},"required":["ids"],"nullable":true}}},{"type":"object","properties":{"episode":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"}},"required":["trakt"]}},"required":["ids"],"nullable":true}}},{"type":"object","properties":{"list":{"type":"object","properties":{"ids":{"type":"object","properties":{"trakt":{"type":"integer"}},"required":["trakt"]}},"required":["ids"],"nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"parent_id":{"type":"integer"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"comment":{"type":"string"},"gif":{"type":"object","properties":{"url":{"type":"string"},"slug":{"type":"string","nullable":true}},"required":["url"],"nullable":true},"spoiler":{"type":"boolean"},"review":{"type":"boolean"},"replies":{"type":"integer"},"likes":{"type":"integer"},"language":{"type":"string","nullable":true},"user_rating":{"type":"integer","nullable":true},"user_stats":{"type":"object","properties":{"rating":{"type":"integer","nullable":true},"play_count":{"type":"integer"},"completed_count":{"type":"integer"}},"required":["play_count","completed_count"]},"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["id","parent_id","created_at","updated_at","comment","spoiler","review","replies","likes","user_stats","user"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"postCommentsPost"}},"/certifications/{type}":{"get":{"description":"Get a list of all certifications, including names, slugs, and descriptions.","summary":"Get certifications","tags":["certifications"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["movies","shows"]},"description":"Certification media type."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"us":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"}},"required":["name","slug","description"]}}},"required":["us"]},{"type":"object","properties":{"us":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"}},"required":["name","slug","description"]}}},"required":["us"]}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCertificationsList"}},"/certifications/shows":{"get":{"description":"Returns show certifications grouped by country, including certification name, slug, and description.","summary":"Get show certifications","tags":["certifications"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"us":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"}},"required":["name","slug","description"]}}},"required":["us"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCertificationsShows"}},"/certifications/movies":{"get":{"description":"Returns movie certifications grouped by country, including certification name, slug, and description.","summary":"Get movie certifications","tags":["certifications"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"us":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"}},"required":["name","slug","description"]}}},"required":["us"]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCertificationsMovies"}},"/countries/{type}":{"get":{"description":"Get a list of all countries, including names and codes.","summary":"Get countries","tags":["countries"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["movies","shows"]},"description":"Media type to return countries for."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string"}},"required":["name","code"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getCountriesList"}},"/genres/{type}":{"get":{"description":"Get a list of all genres, including names and slugs.\n\n#### Subgenres\n\nSend `?extended=subgenres` to get a list of subgenres for each genre. You can get more creative with advanced filters by using the subgenres in your app.","summary":"Get genres","tags":["genres"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["movies","shows"]},"description":"Media type to return genres for."},{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"subgenres":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}},"required":["name","slug"]}}},"required":["name","slug"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getGenresList"}},"/languages/{type}":{"get":{"description":"Get a list of all languages, including names and codes.","summary":"Get languages","tags":["languages"],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["movies","shows"]},"description":"Media type to return languages for."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string"}},"required":["name","code"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getLanguagesList"}},"/networks":{"get":{"description":"Get a list of all TV networks, including names.","summary":"Get networks","tags":["networks"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string","nullable":true}},"required":["name"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getNetworksList"}},"/scrobble/start":{"post":{"description":"#### 🔒 OAuth Required\nUse this method when the video initially starts playing or is unpaused. This will remove any playback progress if it exists.\n\n> ### Note\n> _A watching status will auto expire after the remaining runtime has elapsed. There is no need to call this method again while continuing to watch the same item._\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie` or `episode` object. (see examples ->) |\n| `progress` * | float | Progress percentage between 0 and 100. |","summary":"Start watching in a media center","tags":["scrobble"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"progress":{"type":"number","format":"float"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["title","year","ids"],"nullable":true}},"required":["progress"]},{"type":"object","properties":{"progress":{"type":"number","format":"float"},"episode":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true}},"required":["progress"]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postScrobbleStart"}},"/scrobble/pause":{"post":{"description":"#### 🔒 OAuth Required\nPause an active scrobble for a movie or episode. Send the media object and current progress in the request body; the response returns the updated scrobble state.","summary":"Pause watching in a media center","tags":["scrobble"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"progress":{"type":"number","format":"float"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["title","year","ids"],"nullable":true}},"required":["progress"]},{"type":"object","properties":{"progress":{"type":"number","format":"float"},"episode":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true}},"required":["progress"]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postScrobblePause"}},"/scrobble/stop":{"post":{"description":"#### 🔒 OAuth Required\nUse this method when the video is stopped or finishes playing on its own. If the progress is above 80%, the video will be scrobbled and the `action` will be set to **scrobble**. A unique history `id` (64-bit integer) will be returned and can be used to reference this `scrobble` directly.\n\nIf the progress is between 1% and 79%, it will be treated as a *pause* and the `action` will be set to **pause**. The playback progress will be saved and [**/sync/playback**](/reference/sync/playback/) can be used to resume the video from this exact position.\n\n> ### Note\n> _If the progress is less than 1%, you'll get a `422` HTTP status code response and the scrobble will be ignored._\n\n#### JSON POST Data\n| Key | Type | Value |\n|---|---|---|\n| item * | object | `movie` or `episode` object. (see examples ->) |\n| `progress` * | flloat | Progress percentage between 0 and 100. |\n\n> ### Note\n> _If the same item was just scrobbled, a `409` HTTP status code will returned to avoid scrobbling a duplicate. The response will contain a `watched_at` timestamp when the item was last scrobbled and a `expires_at` timestamp when the item can be scrobbled again._","summary":"Stop or finish watching in a media center","tags":["scrobble"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"progress":{"type":"number","format":"float"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["slug"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"slug":{"type":"string","nullable":true,"description":"Slug"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"}},"required":["tmdb"]}]}},"required":["title","year","ids"],"nullable":true}},"required":["progress"]},{"type":"object","properties":{"progress":{"type":"number","format":"float"},"episode":{"type":"object","properties":{"ids":{"oneOf":[{"type":"object","properties":{"trakt":{"type":"integer"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["trakt"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["imdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer"},"tvdb":{"type":"integer","nullable":true,"description":"TVDb ID"}},"required":["tmdb"]},{"type":"object","properties":{"trakt":{"type":"integer","nullable":true,"description":"Trakt ID"},"imdb":{"type":"string","nullable":true,"description":"IMDb ID"},"tmdb":{"type":"integer","nullable":true,"description":"TMDb ID"},"tvdb":{"type":"integer"}},"required":["tvdb"]}]}},"required":["ids"],"nullable":true}},"required":["progress"]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"movie":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"slug":{"type":"string"},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"runtime":{"type":"integer","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"certification":{"type":"string","nullable":true},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]},{"type":"object","properties":{"id":{"type":"number","format":"int64"},"progress":{"type":"number","format":"float"},"action":{"type":"string"},"episode":{"type":"object","properties":{"season":{"type":"integer"},"number":{"type":"integer"},"title":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"released":{"type":"string","nullable":true},"effective_release_date":{"type":"string","nullable":true},"number_abs":{"type":"integer","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"updated_at":{"type":"string","nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"runtime":{"type":"integer","nullable":true},"overview":{"type":"string","nullable":true},"episode_type":{"type":"string","enum":["standard","series_premiere","season_premiere","mid_season_finale","mid_season_premiere","season_finale","series_finale"],"nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true}},"required":["trakt"]},"original_title":{"type":"string","nullable":true},"after_credits":{"type":"boolean","nullable":true},"during_credits":{"type":"boolean","nullable":true},"images":{"type":"object","properties":{"screenshot":{"type":"array","items":{"type":"string"}}},"required":["screenshot"],"nullable":true}},"required":["season","number","ids"],"nullable":true},"show":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer","nullable":true},"ids":{"type":"object","properties":{"trakt":{"type":"integer"},"tvdb":{"type":"integer","nullable":true},"imdb":{"type":"string","nullable":true},"tmdb":{"type":"integer","nullable":true},"plex":{"type":"object","properties":{"guid":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true}},"nullable":true},"slug":{"type":"string"}},"required":["trakt","slug"]},"images":{"type":"object","properties":{"fanart":{"type":"array","items":{"type":"string"}},"poster":{"type":"array","items":{"type":"string"}},"logo":{"type":"array","items":{"type":"string"}},"clearart":{"type":"array","items":{"type":"string"}},"banner":{"type":"array","items":{"type":"string"}},"thumb":{"type":"array","items":{"type":"string"}}},"required":["fanart","poster","logo","clearart","banner","thumb"],"nullable":true},"aired_episodes":{"type":"integer","nullable":true},"tagline":{"type":"string","nullable":true},"overview":{"type":"string","nullable":true},"first_aired":{"type":"string","nullable":true},"last_aired":{"type":"string","nullable":true},"airs":{"type":"object","properties":{"day":{"type":"string","nullable":true},"time":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}},"nullable":true},"runtime":{"type":"integer","nullable":true},"total_runtime":{"type":"integer","nullable":true,"description":"Total runtime in minutes. When exact runtime data is unavailable, this value may include estimated fallback runtimes and should be treated as an approximation."},"certification":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"ending":{"type":"string","nullable":true},"rating":{"type":"number","format":"float","nullable":true},"votes":{"type":"integer","nullable":true},"comment_count":{"type":"integer","nullable":true},"trailer":{"type":"string","nullable":true},"homepage":{"type":"string","nullable":true},"updated_at":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"},"nullable":true},"available_translations":{"type":"array","items":{"type":"string"},"nullable":true},"genres":{"type":"array","items":{"type":"string"},"nullable":true},"subgenres":{"type":"array","items":{"type":"string"},"nullable":true},"original_title":{"type":"string","nullable":true},"colors":{"type":"object","properties":{"poster":{"type":"array","items":{"type":"string"},"nullable":true}},"nullable":true},"social_ids":{"type":"object","properties":{"twitter":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"wikipedia":{"type":"string","nullable":true}},"nullable":true}},"required":["title","ids"],"nullable":true}},"required":["id","progress","action"]}]}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postScrobbleStop"}},"/team/":{"get":{"description":"#### ✨ Extended Info\nReturns Trakt team members. Use `extended` to include additional person details and images when available.","summary":"Get team members","tags":["team"],"parameters":[{"name":"extended","in":"query","description":"Extended information to include in the response.","schema":{"nullable":true}}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"user":{"type":"object","properties":{"username":{"type":"string"},"private":{"type":"boolean"},"deleted":{"type":"boolean"},"name":{"type":"string","nullable":true},"vip":{"type":"boolean","nullable":true},"vip_ep":{"type":"boolean","nullable":true},"director":{"type":"boolean","nullable":true},"ids":{"type":"object","properties":{"slug":{"type":"string","nullable":true},"trakt":{"type":"integer"}},"required":["trakt"]},"joined_at":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"about":{"type":"string","nullable":true},"gender":{"type":"string","nullable":true},"age":{"type":"integer","nullable":true},"images":{"type":"object","properties":{"avatar":{"type":"object","properties":{"full":{"type":"string"}},"required":["full"]}},"required":["avatar"],"nullable":true},"vip_og":{"type":"boolean","nullable":true},"vip_years":{"type":"integer","nullable":true},"vip_cover_image":{"type":"string","nullable":true},"vip_veteran_since":{"type":"string","nullable":true},"vip_veteran_years":{"type":"integer","nullable":true},"vip_veteran_tier":{"type":"integer","nullable":true},"vip_veteran_title":{"type":"string","nullable":true},"vip_grace_ends_at":{"type":"string","nullable":true}},"required":["username","private","deleted","ids"]}},"required":["user"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]},{"traktAPI":[]}],"operationId":"getTeamMembers"}},"/younify/connections":{"get":{"description":"#### 🔒 OAuth Required\nLists every connectable streaming service with the current user's connection status merged in, so a settings grid can render each tile in one pass. Read-only — never creates a remote younify user.\n\n> ### IMPORTANT\n> _**Array order is significant.** Clients must preserve the response order when rendering the grid; the list is returned in the intended display order._\n\n`vip: false` is the free tier. `connectable` reflects whether the current user may connect the service on their plan. `connected` plus `active` indicate a healthy link (`active: false` is a broken link). `profile` and `last_synced_at` are null when not connected, and `last_synced_at` is normalized to `.000Z`.","summary":"Get streaming connections","tags":["younify"],"parameters":[],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The streaming service id (e.g. `netflix`)."},"name":{"type":"string"},"vip":{"type":"boolean","description":"Whether the service requires Trakt VIP. `false` is the free tier."},"color":{"type":"string"},"images":{"type":"object","properties":{"logo":{"type":"string","nullable":true}},"required":["logo"]},"connectable":{"type":"boolean","description":"Whether the current user may connect this service (VIP gating). Use to show Connect vs an upsell."},"connected":{"type":"boolean","description":"Whether the service is linked for the current user."},"active":{"type":"boolean","description":"Whether the link is healthy. `false` means a broken link."},"profile":{"type":"string","nullable":true,"description":"The connected profile name, or null when not connected."},"last_synced_at":{"type":"string","nullable":true,"description":"When the service last synced, normalized to `.000Z`, or null when not connected."}},"required":["id","name","vip","color","images","connectable","connected","active","profile","last_synced_at"]}}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"getYounifyConnections"}},"/younify/connect":{"post":{"description":"#### 🔒 OAuth Required\nMints a signed younify web-auth URL for the client to open. Accepts the client's own `return_url` (deep link / universal link), validated against trakt-owned destinations only (`trakt://…` or `https://*.trakt.tv`).\n\nA `422` is returned when the service is not connectable on the user's plan, and a `400` when the `return_url` is missing/invalid or no URL could be minted.","summary":"Create a streaming connection","tags":["younify"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"service_id":{"type":"string","description":"The streaming service to connect (e.g. `netflix`)."},"return_url":{"type":"string","description":"Where the younify web-auth flow returns the user once complete. Must be a trakt-owned destination (`trakt://…` or `https://*.trakt.tv`)."}},"required":["service_id","return_url"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The signed younify web-auth URL for the client to open."}},"required":["url"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{}}}},"422":{"description":"422","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postYounifyConnect"}},"/younify/users/refresh":{"post":{"description":"#### 🔒 OAuth Required\nQueue a re-sync of the connected streaming service named by `service_id` in the body. Free accounts only sync the service within their limit.","summary":"Refresh a streaming service (service in the body)","tags":["younify"],"parameters":[],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"skip_sync":{"type":"boolean","description":"Only mark the service as synced now, so history from before this moment is ignored."},"service_id":{"type":"string","description":"The streaming service to re-sync (e.g. `netflix`)."}},"required":["service_id"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postYounifyRefreshService"}},"/younify/users/refresh/{service_id}":{"post":{"description":"#### 🔒 OAuth Required\nQueue / force a re-sync of a connected streaming service for the authenticated user.","summary":"Refresh a streaming service","tags":["younify"],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string"},"description":"The streaming service id (e.g. `netflix`)."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"skip_sync":{"type":"boolean","description":"Only mark the service as synced now, so history from before this moment is ignored."}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postYounifyRefresh"}},"/younify/users/refresh/{service_id}/{all_data}":{"post":{"description":"#### 🔒 OAuth Required\nQueue / force a re-sync of a connected streaming service for the authenticated user. An `all_data` segment of `true` forces a full re-sync of all data rather than an incremental one.","summary":"Refresh a streaming service (full re-sync)","tags":["younify"],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string"},"description":"The streaming service id to re-sync (e.g. `netflix`)."},{"name":"all_data","in":"path","required":true,"schema":{"type":"string","enum":["true","false"]},"description":"`true` forces a full re-sync of all data, `false` an incremental one."}],"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"skip_sync":{"type":"boolean","description":"Only mark the service as synced now, so history from before this moment is ignored."}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"postYounifyRefreshAll"}},"/younify/users/services/{service_id}":{"delete":{"description":"#### 🔒 OAuth Required\nUnlink a streaming service from the authenticated user.","summary":"Unlink a streaming service","tags":["younify"],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string"},"description":"The streaming service id (e.g. `netflix`)."}],"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}}},"security":[{"traktAPI":[],"traktOAuth":[]}],"operationId":"deleteYounifyDisconnect"}}},"info":{"title":"Trakt API","version":"2.0.0"},"servers":[{"url":"https://api.trakt.tv","description":"Production"},{"url":"https://apiz.trakt.tv","description":"Private production"}],"components":{"securitySchemes":{"traktAPI":{"type":"apiKey","in":"header","name":"trakt-api-key"},"traktOAuth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.trakt.tv/oauth/authorize","tokenUrl":"https://auth.trakt.tv/oauth/token","scopes":{"public":"Access public data"}}}}}},"x-readme":{"oauth-options":{"usePkce":true},"headers":[{"key":"User-Agent","value":"readme/1.0"},{"key":"trakt-api-version","value":"2"}]}}