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

Key	Type	Description
id	int	The id of the episode (starting from 1).
name	string	The name of the episode.
air_date	string	The air date of the episode.
director	string	The director of the episode.
writer	string	The writer of the episode.
characters	array	Different characters of the episode.
img_url	string (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"
  }
]

Episode schema​

Get all episodes​

Get a single episode​

Sort the response​

Limit the response​

Use limit with sort​