Skip to main content

Episode

Currently there are 36 episodes spanning over three seasons released in 2018, 2019 and 2021.

Season 1 premiered on TBS and consists of 10 episodes which are named as Chapter 1, Chapter 2, Chapter 3, etc.

Season 2 premiered in 2019 on Adult Swim and consists of 13 episodes.

Season 3 premiered on March 20, 2021 and consists of 13 episodes.

Episode schema#

KeyTypeDescription
idintThe id of the episode (starting from 1).
namestringThe name of the episode.
air_datestringThe air date of the episode.
directorstringThe director of the episode.
writerstringThe writer of the episode.
charactersarrayDifferent characters of the episode.
img_urlstring (url)Link to the episode's image. (640x480)

Get all episodes#

You can access the list of episodes by using the /episode endpoint.

https://finalspaceapi.com/api/v0/episode/
[  {    "id": 1,    "name": "Chapter 1",    "air_date": "02/15/2018",    "director": "Mike Roberts",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/2",      "https://finalspaceapi.com/api/v0/character/3",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/11"    ],    "img_url": "http://finalspaceapi.com/episode/image/chapter1.jpg"  }, ...]

Get a single episode#

You can get a single episode by adding the id as a parameter: /episode/15

https://finalspaceapi.com/api/v0/episode/15
{  "id": 15,  "name": "The Notorious Mrs. Goodspeed",  "air_date": "06/22/2019",  "director": "Yoriaki Mochizuki",  "writer": "Olan Rogers",  "characters": [    "https://finalspaceapi.com/api/v0/character/1",    "https://finalspaceapi.com/api/v0/character/4",    "https://finalspaceapi.com/api/v0/character/6",    "https://finalspaceapi.com/api/v0/character/7",    "https://finalspaceapi.com/api/v0/character/8",    "https://finalspaceapi.com/api/v0/character/9",    "https://finalspaceapi.com/api/v0/character/10",    "https://finalspaceapi.com/api/v0/character/11",    "https://finalspaceapi.com/api/v0/character/12",    "https://finalspaceapi.com/api/v0/character/13",    "https://finalspaceapi.com/api/v0/character/16"  ],  "img_url": "http://finalspaceapi.com/episode/image/the_notorious_mrs_goodspeed.jpg"}

Sort the response#

You can now sort the response based on id by passing the /?sort=asc or /?sort=desc query in the URL.

https://finalspaceapi.com/api/v0/episode/?sort=desc
[  {    "id": 23,    "name": "The Sixth Key",    "air_date": "08/23/2019",    "director": "Yoriaki Mochizuki",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/7",      "https://finalspaceapi.com/api/v0/character/8",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/12",      "https://finalspaceapi.com/api/v0/character/13",      "https://finalspaceapi.com/api/v0/character/16"    ],    "img_url": "http://finalspaceapi.com/episode/image/the_sixth_key.jpg"  },  ...]

Limit the response#

You can now limit the response by passing the /?limit={number} query in the URL.

https://finalspaceapi.com/api/v0/episode/?limit=3
[  {    "id": 1,    "name": "Chapter 1",    "air_date": "02/15/2018",    "director": "Mike Roberts",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/2",      "https://finalspaceapi.com/api/v0/character/3",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/11"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/chapter1.jpg"  },  {    "id": 2,    "name": "Chapter 2",    "air_date": "02/15/2018",    "director": "Mike Roberts",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/2",      "https://finalspaceapi.com/api/v0/character/3",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/10",      "https://finalspaceapi.com/api/v0/character/12",      "https://finalspaceapi.com/api/v0/character/14"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/chapter2.jpg"  },  {    "id": 3,    "name": "Chapter 3",    "air_date": "02/26/2018",    "director": "Mike Roberts",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/3",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/11",      "https://finalspaceapi.com/api/v0/character/14"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/chapter3.jpg"  }]

Use limit with sort#

You can limit and sort the response simultaneously by passing both limit={number} and sort=desc query parameters in the URL and seperating them with & operator.

https://finalspaceapi.com/api/v0/episode/?limit=3&sort=desc
[  {    "id": 23,    "name": "The Sixth Key",    "air_date": "08/23/2019",    "director": "Yoriaki Mochizuki",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/5",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/7",      "https://finalspaceapi.com/api/v0/character/8",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/12",      "https://finalspaceapi.com/api/v0/character/13",      "https://finalspaceapi.com/api/v0/character/16"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/the_sixth_key.jpg"  },  {    "id": 22,    "name": "The Descent Into Darkness",    "air_date": "08/16/2019",    "director": "Yoriaki Mochizuki",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/7",      "https://finalspaceapi.com/api/v0/character/8",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/12",      "https://finalspaceapi.com/api/v0/character/13",      "https://finalspaceapi.com/api/v0/character/16",      "https://finalspaceapi.com/api/v0/character/17"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/the_descent_into_darkness.jpg"  },  {    "id": 21,    "name": "The Set Up",    "air_date": "08/09/2019",    "director": "Anne Walker Farrell",    "writer": "Olan Rogers",    "characters": [      "https://finalspaceapi.com/api/v0/character/1",      "https://finalspaceapi.com/api/v0/character/4",      "https://finalspaceapi.com/api/v0/character/6",      "https://finalspaceapi.com/api/v0/character/7",      "https://finalspaceapi.com/api/v0/character/8",      "https://finalspaceapi.com/api/v0/character/9",      "https://finalspaceapi.com/api/v0/character/10",      "https://finalspaceapi.com/api/v0/character/12",      "https://finalspaceapi.com/api/v0/character/13",      "https://finalspaceapi.com/api/v0/character/16"    ],    "img_url": "http://finalspaceapi.com/api/episode/image/the_set_up.jpg"  }]