> ## Documentation Index > Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Rated TV Episodes > This endpoint get a users list of rated TV episodes. ## OpenAPI ````yaml api-reference/openapi3.json get /3/account/{account_id}/rated/tv/episodes openapi: 3.0.3 info: title: The Movie Database version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: AUTHENTICATION - name: ACCOUNT - name: CERTIFICATIONS - name: CHANGES - name: COLLECTIONS - name: COMPANY - name: CONFIGURATION - name: CREDIT - name: DISCOVER - name: FIND - name: GENRES - name: GUEST SESSIONS - name: KEYWORDS - name: LISTS - name: MOVIE LISTS - name: MOVIES - name: NETWORKS - name: PEOPLE LIST - name: PEOPLE - name: REVIEWS - name: SEARCH - name: TRENDING - name: TV SERIES LIST - name: TV SERIES - name: TV SEASONS - name: TV EPISODES - name: TV EPISODE GROUP - name: WATCH PROVIDERS paths: /3/account/{account_id}/rated/tv/episodes: get: tags: - ACCOUNT summary: Rated TV Episodes description: This endpoint get a users list of rated TV episodes. operationId: ratedTvEpisodes parameters: - $ref: '#/components/parameters/language' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/session_id' - $ref: '#/components/parameters/sort_by' - $ref: '#/components/parameters/account_id' responses: '200': description: rated tv episodes headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=0 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Mon, 16 Dec 2024 15:37:34 GMT ETag: schema: type: string example: W/"5b333525ff117973180331432dc740b8" Server: schema: type: string example: openresty Transfer-Encoding: schema: type: string example: chunked Vary: schema: type: string example: Origin Via: schema: type: string example: >- 1.1 10a9e9969f05a75cc05e6f70b8499f7e.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: CEWzjLVjzuHocSfZ6QtwJ5ptQSmD10MmpkE5QnwAt9HsMzf5feVGYw== X-Amz-Cf-Pop: schema: type: string example: IAD89-C3 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: MISS x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '0' x-memc-key: schema: type: string example: 6f88d0a3ea2e7d8a2e0c9f86e2260657 content: application/json: schema: type: object properties: page: type: number example: 1 description: >- Indicates the current page number of the results being returned. results: type: array items: type: object properties: air_date: type: string example: '2013-10-17' description: >- The date when the episode originally aired, formatted as YYYY-MM-DD. episode_number: type: number example: 5 description: The specific episode number within its season. id: type: number example: 64782 description: A unique identifier for the episode. name: type: string example: The Workplace Proximity description: The title of the episode. overview: type: string example: >- Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. description: A brief summary of the episode's plot. production_code: type: string example: 4X5305 description: >- A code used for identifying the episode during production; may be empty if not specified. rating: type: number example: 8 description: >- An integer that serves as a custom rating value that may reflect how the episode is perceived overall. runtime: type: number example: 22 description: The duration of the episode in minutes. season_number: type: number example: 7 description: The season number in which the episode is aired. show_id: type: number example: 1418 description: >- A unique identifier for the TV show to which the episode belongs. still_path: type: string example: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg description: >- A relative path to an image representing the episode; often used for displaying a thumbnail. vote_average: type: number example: 7.242 description: >- The average rating given to the episode, typically on a scale of 1 to 10. vote_count: type: number example: 31 description: >- The total number of votes or ratings received for the episode. example: - air_date: '2013-10-17' episode_number: 5 id: 64782 name: The Workplace Proximity overview: >- Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. production_code: 4X5305 rating: 8 runtime: 22 season_number: 7 show_id: 1418 still_path: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg vote_average: 7.242 vote_count: 31 - air_date: '2013-12-08' episode_number: 11 id: 968782 name: Big Man in Tehran overview: >- Brody's loyalty to the mission wavers when he meets a ghost from his past. As Lockhart's confirmation looms, Saul stares into the precipice between success and failure. production_code: 3WAH11 rating: 9 runtime: 55 season_number: 3 show_id: 1407 still_path: /2JYvwe7HoEkn3BQhhHCyPzhqhh5.jpg vote_average: 8 vote_count: 23 - air_date: '2014-03-23' episode_number: 15 id: 973273 name: Dramatics, Your Honor overview: >- Alicia asks Cary to be her lawyer when Nelson Dubeck (Eric Bogosian) asks her to participate in a deposition; Will faces off with a new prosecutor while defending Jeffrey Grant (Hunter Parrish). production_code: '' rating: 9 runtime: 43 season_number: 5 show_id: 1435 still_path: /eGQg94nfM6EhKrxGA8A92SXe3WT.jpg vote_average: 8.2 vote_count: 11 - air_date: '2014-05-11' episode_number: 6 id: 63099 name: The Laws of Gods and Men overview: >- Stannis makes a deal with the Iron Bank of Braavos. Yara and her troops storm the Dreadfort to free Theon. Meanwhile, Daenerys meets Hizdar zo Loraq and her other supplicants. And the day of Tyrion's trial has come where Tyrion faces his father. production_code: '406' rating: 8.5 runtime: 51 season_number: 4 show_id: 1399 still_path: /vKt9b7HNYhwM91C7S53zPsAWfT3.jpg vote_average: 9 vote_count: 133 - air_date: '2014-05-18' episode_number: 7 id: 63100 name: Mockingbird overview: >- Tyrion gains an unlikely ally; Daario asks Dany to allow him to do what he does best; Jon's warnings about the vulnerability of the Wall are ignored; Brienne follows a new lead. production_code: '407' rating: 8.5 runtime: 51 season_number: 4 show_id: 1399 still_path: /r7u0uELPyDkNnBZzAFVvw1XJKo5.jpg vote_average: 8.2 vote_count: 116 - air_date: '2014-05-16' episode_number: 12 id: 975339 name: Tome-wan overview: >- Bedelia returns and accepts immunity to testify against Hannibal. Mason Verger plots revenge after learning of Hannibal's manipulations. production_code: '212' rating: 9 runtime: 43 season_number: 2 show_id: 40008 still_path: /pYsO5cXmjJGYUZWVDocBI3CIM6.jpg vote_average: 8.2 vote_count: 32 - air_date: '2014-05-23' episode_number: 13 id: 976285 name: Mizumono overview: >- Springing their trap, Jack, Will and Alana face off with Hannibal in a bloody final showdown, but the doctor has a few surprises of his own. production_code: '213' rating: 10 runtime: 43 season_number: 2 show_id: 40008 still_path: /40jqX3XRk6W97gscX5rj4kTy411.jpg vote_average: 9 vote_count: 47 - air_date: '2014-06-01' episode_number: 8 id: 63101 name: The Mountain and the Viper overview: >- Unexpected visitors arrive in Mole's Town. With assistance from Theon, Ramsay proves himself to his father, Lord Bolton. Littlefinger's motives are questioned when Sansa reveals the fate of Lysa Arryn to other lords of the Vale. Daenerys finds out a secret about Jorah Mormont. Tyrion's fate is decided. production_code: '408' rating: 9.5 runtime: 53 season_number: 4 show_id: 1399 still_path: /exdPjUiilNFUV8uUSiBBhsanAwa.jpg vote_average: 8.9 vote_count: 141 - air_date: '2013-09-29' episode_number: 16 id: 62161 name: Felina overview: All bad things must come to an end. production_code: '' rating: 9 runtime: 56 season_number: 5 show_id: 1396 still_path: /pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg vote_average: 9.2 vote_count: 172 - air_date: '2014-07-13' episode_number: 1 id: 989249 name: Night Zero overview: >- When a plane lands in New York City with everyone on board dead, Dr. Ephraim Goodweather, head of the CDC’s Canary Project, and his team are called upon to investigate. Harlem pawnbroker Abraham Setrakian races to the airport, convinced that what looks at first like a mysterious viral outbreak might be the beginning of something infinitely more sinister. production_code: XSN01001 rating: 7.5 runtime: 44 season_number: 1 show_id: 47640 still_path: /18fgFoUhfDW4PVNOnwonaRXMJMe.jpg vote_average: 7.6 vote_count: 35 - air_date: '2014-06-19' episode_number: 1 id: 976915 name: Running with the Bull overview: >- Daniel’s family fears he won’t recover from his injuries and his attackers will escape justice. Judy Dean shows Bobby some unexpected affection. Ted, Jr. hides a shameful secret from his wife. Sheriff Daggett investigates Daniel’s beating. production_code: '' rating: 9 runtime: 47 season_number: 2 show_id: 46619 still_path: /8fpa0GjYpSaAaEI5f2JiP1dkrqc.jpg vote_average: 8.7 vote_count: 9 - air_date: '2014-08-24' episode_number: 9 id: 990362 name: The Garveys at Their Best overview: >- Kevin tries to suppress his bad habits while tracking down a marauding deer in Mapleton. Laurie receives not-unexpected news amidst a rising sense of foreboding. Tom connects with his past, against his better judgment. Nora has a job interview; Kevin Senior receives an honor. production_code: 4X5709 rating: 9 runtime: 60 season_number: 1 show_id: 54344 still_path: /gGLWdy0ac2OryUwfGd3y0TiHTpD.jpg vote_average: 8.5 vote_count: 20 - air_date: '2012-07-15' episode_number: 1 id: 62147 name: Live Free or Die overview: >- As Walt deals with the aftermath of the Casa Tranquila explosion, Hank works to wrap up his investigation of Gus' empire. production_code: '' rating: 8 runtime: 43 season_number: 5 show_id: 1396 still_path: /uShB5dWoA3xIivZ9jvwWnGCVvt4.jpg vote_average: 8.6 vote_count: 122 - air_date: '2012-08-26' episode_number: 7 id: 62153 name: Say My Name overview: >- Walt takes control of business matters; Mike deals with the consequences of his actions. production_code: '' rating: 8.5 runtime: 48 season_number: 5 show_id: 1396 still_path: /2NA7ti9jsWnG4xreMEFwbq4DH1f.jpg vote_average: 8.9 vote_count: 117 - air_date: '2015-03-01' episode_number: 1 id: 1022053 name: The Battle Creek Way overview: >- Jaded Det. Russ Agnew reluctantly partners with charming FBI Agent Milt Chamberlain to solve a drug-related double homicide, but while Milt investigates with the high-tech resources of the FBI, Russ prefers old-school police work and instinct. production_code: '101' rating: 8 runtime: 60 season_number: 1 show_id: 61676 still_path: /d7i0ChoPXU4VbdFWCNtFOqTZTk8.jpg vote_average: 7.4 vote_count: 7 - air_date: '2015-02-23' episode_number: 16 id: 1039439 name: The Wrong Stuff overview: >- When an astronaut, training for a trip to Mars, is mysteriously killed inside a Mars simulation, Castle and Beckett don spacesuits to investigate. But when they discover no one inside the sealed simulation could have committed the murder and no one from the outside could get in, the case takes a shocking turn production_code: '716' rating: 8 runtime: 45 season_number: 7 show_id: 1419 still_path: /kg0beAZYaaLVsP3mMxVnwDcG1f8.jpg vote_average: 7.5 vote_count: 13 - air_date: '2015-04-10' episode_number: 13 id: 1036361 name: Daredevil overview: >- In the season finale, a boxed-in Fisk and a desperate Murdock, Foggy and Karen are forced to play their end games. production_code: '' rating: 9.5 runtime: 57 season_number: 1 show_id: 61889 still_path: /nSCJMlJkGULVKHuisKeH9Crguy8.jpg vote_average: 8.4 vote_count: 75 - air_date: '2015-03-20' episode_number: 1 id: 1040171 name: Part 1 overview: >- Trouble starts when oldest son Danny Rayburn comes home for the 45th anniversary celebration of his parents' hotel in the Florida Keys' Islamorada. production_code: '' rating: 8.5 runtime: 60 season_number: 1 show_id: 61986 still_path: /qfMRZLmVPm6ubFC1NxSVRm7RLnq.jpg vote_average: 7.7 vote_count: 14 - air_date: '2015-05-31' episode_number: 8 id: 1070282 name: Hardhome overview: >- Arya makes progress in her training. Sansa confronts an old friend. Cersei struggles. Jon travels. production_code: '508' rating: 10 runtime: 61 season_number: 5 show_id: 1399 still_path: /zIrSrXU4zOArlVYnXFxxfKDYYY2.jpg vote_average: 9.3 vote_count: 170 - air_date: '2011-04-17' episode_number: 1 id: 63056 name: Winter Is Coming overview: >- Jon Arryn, the Hand of the King, is dead. King Robert Baratheon plans to ask his oldest friend, Eddard Stark, to take Jon's place. Across the sea, Viserys Targaryen plans to wed his sister to a nomadic warlord in exchange for an army. production_code: '101' rating: 9 runtime: 62 season_number: 1 show_id: 1399 still_path: /9hGF3WUkBf7cSjMg0cdMDHJkByd.jpg vote_average: 7.8 vote_count: 285 description: >- This represents a collection of movie objects returned by the API that provides information about various films. total_pages: type: number example: 10 description: The total number of pages available in the results. total_results: type: number example: 186 description: The total number of results found for the query submitted. examples: rated tv episodes: value: page: 1 results: - air_date: '2013-10-17' episode_number: 5 id: 64782 name: The Workplace Proximity overview: >- Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes. production_code: 4X5305 rating: 8 runtime: 22 season_number: 7 show_id: 1418 still_path: /k8atjbd5gAsntuhbPnFpvnvo0qn.jpg vote_average: 7.242 vote_count: 31 - air_date: '2013-12-08' episode_number: 11 id: 968782 name: Big Man in Tehran overview: >- Brody's loyalty to the mission wavers when he meets a ghost from his past. As Lockhart's confirmation looms, Saul stares into the precipice between success and failure. production_code: 3WAH11 rating: 9 runtime: 55 season_number: 3 show_id: 1407 still_path: /2JYvwe7HoEkn3BQhhHCyPzhqhh5.jpg vote_average: 8 vote_count: 23 - air_date: '2014-03-23' episode_number: 15 id: 973273 name: Dramatics, Your Honor overview: >- Alicia asks Cary to be her lawyer when Nelson Dubeck (Eric Bogosian) asks her to participate in a deposition; Will faces off with a new prosecutor while defending Jeffrey Grant (Hunter Parrish). production_code: '' rating: 9 runtime: 43 season_number: 5 show_id: 1435 still_path: /eGQg94nfM6EhKrxGA8A92SXe3WT.jpg vote_average: 8.2 vote_count: 11 - air_date: '2014-05-11' episode_number: 6 id: 63099 name: The Laws of Gods and Men overview: >- Stannis makes a deal with the Iron Bank of Braavos. Yara and her troops storm the Dreadfort to free Theon. Meanwhile, Daenerys meets Hizdar zo Loraq and her other supplicants. And the day of Tyrion's trial has come where Tyrion faces his father. production_code: '406' rating: 8.5 runtime: 51 season_number: 4 show_id: 1399 still_path: /vKt9b7HNYhwM91C7S53zPsAWfT3.jpg vote_average: 9 vote_count: 133 - air_date: '2014-05-18' episode_number: 7 id: 63100 name: Mockingbird overview: >- Tyrion gains an unlikely ally; Daario asks Dany to allow him to do what he does best; Jon's warnings about the vulnerability of the Wall are ignored; Brienne follows a new lead. production_code: '407' rating: 8.5 runtime: 51 season_number: 4 show_id: 1399 still_path: /r7u0uELPyDkNnBZzAFVvw1XJKo5.jpg vote_average: 8.2 vote_count: 116 - air_date: '2014-05-16' episode_number: 12 id: 975339 name: Tome-wan overview: >- Bedelia returns and accepts immunity to testify against Hannibal. Mason Verger plots revenge after learning of Hannibal's manipulations. production_code: '212' rating: 9 runtime: 43 season_number: 2 show_id: 40008 still_path: /pYsO5cXmjJGYUZWVDocBI3CIM6.jpg vote_average: 8.2 vote_count: 32 - air_date: '2014-05-23' episode_number: 13 id: 976285 name: Mizumono overview: >- Springing their trap, Jack, Will and Alana face off with Hannibal in a bloody final showdown, but the doctor has a few surprises of his own. production_code: '213' rating: 10 runtime: 43 season_number: 2 show_id: 40008 still_path: /40jqX3XRk6W97gscX5rj4kTy411.jpg vote_average: 9 vote_count: 47 - air_date: '2014-06-01' episode_number: 8 id: 63101 name: The Mountain and the Viper overview: >- Unexpected visitors arrive in Mole's Town. With assistance from Theon, Ramsay proves himself to his father, Lord Bolton. Littlefinger's motives are questioned when Sansa reveals the fate of Lysa Arryn to other lords of the Vale. Daenerys finds out a secret about Jorah Mormont. Tyrion's fate is decided. production_code: '408' rating: 9.5 runtime: 53 season_number: 4 show_id: 1399 still_path: /exdPjUiilNFUV8uUSiBBhsanAwa.jpg vote_average: 8.9 vote_count: 141 - air_date: '2013-09-29' episode_number: 16 id: 62161 name: Felina overview: All bad things must come to an end. production_code: '' rating: 9 runtime: 56 season_number: 5 show_id: 1396 still_path: /pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg vote_average: 9.2 vote_count: 172 - air_date: '2014-07-13' episode_number: 1 id: 989249 name: Night Zero overview: >- When a plane lands in New York City with everyone on board dead, Dr. Ephraim Goodweather, head of the CDC’s Canary Project, and his team are called upon to investigate. Harlem pawnbroker Abraham Setrakian races to the airport, convinced that what looks at first like a mysterious viral outbreak might be the beginning of something infinitely more sinister. production_code: XSN01001 rating: 7.5 runtime: 44 season_number: 1 show_id: 47640 still_path: /18fgFoUhfDW4PVNOnwonaRXMJMe.jpg vote_average: 7.6 vote_count: 35 - air_date: '2014-06-19' episode_number: 1 id: 976915 name: Running with the Bull overview: >- Daniel’s family fears he won’t recover from his injuries and his attackers will escape justice. Judy Dean shows Bobby some unexpected affection. Ted, Jr. hides a shameful secret from his wife. Sheriff Daggett investigates Daniel’s beating. production_code: '' rating: 9 runtime: 47 season_number: 2 show_id: 46619 still_path: /8fpa0GjYpSaAaEI5f2JiP1dkrqc.jpg vote_average: 8.7 vote_count: 9 - air_date: '2014-08-24' episode_number: 9 id: 990362 name: The Garveys at Their Best overview: >- Kevin tries to suppress his bad habits while tracking down a marauding deer in Mapleton. Laurie receives not-unexpected news amidst a rising sense of foreboding. Tom connects with his past, against his better judgment. Nora has a job interview; Kevin Senior receives an honor. production_code: 4X5709 rating: 9 runtime: 60 season_number: 1 show_id: 54344 still_path: /gGLWdy0ac2OryUwfGd3y0TiHTpD.jpg vote_average: 8.5 vote_count: 20 - air_date: '2012-07-15' episode_number: 1 id: 62147 name: Live Free or Die overview: >- As Walt deals with the aftermath of the Casa Tranquila explosion, Hank works to wrap up his investigation of Gus' empire. production_code: '' rating: 8 runtime: 43 season_number: 5 show_id: 1396 still_path: /uShB5dWoA3xIivZ9jvwWnGCVvt4.jpg vote_average: 8.6 vote_count: 122 - air_date: '2012-08-26' episode_number: 7 id: 62153 name: Say My Name overview: >- Walt takes control of business matters; Mike deals with the consequences of his actions. production_code: '' rating: 8.5 runtime: 48 season_number: 5 show_id: 1396 still_path: /2NA7ti9jsWnG4xreMEFwbq4DH1f.jpg vote_average: 8.9 vote_count: 117 - air_date: '2015-03-01' episode_number: 1 id: 1022053 name: The Battle Creek Way overview: >- Jaded Det. Russ Agnew reluctantly partners with charming FBI Agent Milt Chamberlain to solve a drug-related double homicide, but while Milt investigates with the high-tech resources of the FBI, Russ prefers old-school police work and instinct. production_code: '101' rating: 8 runtime: 60 season_number: 1 show_id: 61676 still_path: /d7i0ChoPXU4VbdFWCNtFOqTZTk8.jpg vote_average: 7.4 vote_count: 7 - air_date: '2015-02-23' episode_number: 16 id: 1039439 name: The Wrong Stuff overview: >- When an astronaut, training for a trip to Mars, is mysteriously killed inside a Mars simulation, Castle and Beckett don spacesuits to investigate. But when they discover no one inside the sealed simulation could have committed the murder and no one from the outside could get in, the case takes a shocking turn production_code: '716' rating: 8 runtime: 45 season_number: 7 show_id: 1419 still_path: /kg0beAZYaaLVsP3mMxVnwDcG1f8.jpg vote_average: 7.5 vote_count: 13 - air_date: '2015-04-10' episode_number: 13 id: 1036361 name: Daredevil overview: >- In the season finale, a boxed-in Fisk and a desperate Murdock, Foggy and Karen are forced to play their end games. production_code: '' rating: 9.5 runtime: 57 season_number: 1 show_id: 61889 still_path: /nSCJMlJkGULVKHuisKeH9Crguy8.jpg vote_average: 8.4 vote_count: 75 - air_date: '2015-03-20' episode_number: 1 id: 1040171 name: Part 1 overview: >- Trouble starts when oldest son Danny Rayburn comes home for the 45th anniversary celebration of his parents' hotel in the Florida Keys' Islamorada. production_code: '' rating: 8.5 runtime: 60 season_number: 1 show_id: 61986 still_path: /qfMRZLmVPm6ubFC1NxSVRm7RLnq.jpg vote_average: 7.7 vote_count: 14 - air_date: '2015-05-31' episode_number: 8 id: 1070282 name: Hardhome overview: >- Arya makes progress in her training. Sansa confronts an old friend. Cersei struggles. Jon travels. production_code: '508' rating: 10 runtime: 61 season_number: 5 show_id: 1399 still_path: /zIrSrXU4zOArlVYnXFxxfKDYYY2.jpg vote_average: 9.3 vote_count: 170 - air_date: '2011-04-17' episode_number: 1 id: 63056 name: Winter Is Coming overview: >- Jon Arryn, the Hand of the King, is dead. King Robert Baratheon plans to ask his oldest friend, Eddard Stark, to take Jon's place. Across the sea, Viserys Targaryen plans to wed his sister to a nomadic warlord in exchange for an army. production_code: '101' rating: 9 runtime: 62 season_number: 1 show_id: 1399 still_path: /9hGF3WUkBf7cSjMg0cdMDHJkByd.jpg vote_average: 7.8 vote_count: 285 total_pages: 10 total_results: 186 components: parameters: language: name: language in: query description: Specifies the language in which the response should be returned. schema: type: string example: en-US page: name: page in: query description: >- Indicates which page of results to return. Default is the first page (1). schema: type: integer example: 1 session_id: name: session_id in: query description: >- A token that represents a logged-in user's session after they have authenticated with their TMDB account. schema: type: string example: '' sort_by: name: sort_by in: query description: >- Determines how the results should be sorted. 'created_at.asc' indicates ascending order based on the creation date. schema: type: string enum: - created_at.asc - created_at.desc example: created_at.asc account_id: name: account_id in: path required: true description: This refers to a unique identifier assigned to a user account. schema: type: integer example: '' securitySchemes: bearerAuth: type: http scheme: bearer ````