Character

This is the documentation for the /character endpoint. There are currently 47 characters sorted by id.

Character schema

Key	Type	Description
id	int	The id of the character (starting from 1).
name	string	The name of the character.
status	string	The status of the character.
species	string	The species of the character.
gender	string	The gender of the character.
hair	string	The hair color of the character.
origin	object	Name of the character's origin location.
abilities	array	Different abilities of character.
alias	array	Different names of character.
img_url	string (url)	Link to the character's image. (300x300)

Get all characters

You can access the list of characters by using the /character endpoint.

https://finalspaceapi.com/api/v0/character/

[ {
  "id": 1,
  "name": "Gary Goodspeed",
  "status": "Alive",
  "species": "Human",
  "gender": "Male",
  "hair": "Blonde",
  "alias": [
    "The Gary (by Lord Commander and Invictus)",
    "Thunder Bandit(code name)",
    "Star Dragon(new code name)",
    "Primate(By Clarence)",
    "The Captain (self-proclaimed)",
    "Mommy (by the Dewinter children)",
    "Jerry by (Quinn)",
    "Gerald (by Quinn and the S.A.M.E.S)",
    "Humanoid trash (by Avocato)",
    "Generic Blonde Guy (by Ash)",
    "No-Good Thief (by Avocato/Invictus)",
    "Little Bastard (by Sheryl)",
    "Larry Tumbleweed (by Tribore)",
    "Harry Hoodseed (by Tribore)",
    "Leslie (by Tribore)",
    "Barry (by Tribore)",
    "The Fool Who Died A Thousand Deaths (by Invictus)"
  ],
  "origin": "Earth",
  "abilities": [
    "Piloting",
    "Marksmanship",
    "Hand-to-hand combat",
    "Weapons: Blasters",
    "Weapons: Black hole gun (briefly)",
    "Weapons: Robot arm",
    "Weapons: Laser gun",
    "Weapons: Laser sword"
  ],
  "img_url": "https://finalspaceapi.com/api/character/avatar/gary_goodspeed.png"
}
  ...
]

Get a single character

You can get a single character by adding the id as a parameter: /character/5

https://finalspaceapi.com/api/v0/character/5

{
  "id": 5,
  "name": "Avocato",
  "status": "Alive",
  "species": "Ventrexian",
  "gender": "Male",
  "hair": "Dark Teal / White ",
  "alias": [
    "General Avocato",
    "Mr. Whiskers (by Gary)",
    "Cat Guy (by Gary)",
    "Dad (by Little Cato)",
    "My Boyfriend (by Gary)",
    "Furry Fantasy Dad Guy (by Biskit)",
    "Daddy-O (by Little Cato)",
    "Pops (by Little Cato)",
    "Ventrexian Filth (by Ash)"
  ],
  "origin": "Ventrexia",
  "abilities": ["Marksmanship", "Surgery", "Combat prowess"],
  "img_url": "https://finalspaceapi.com/api/character/avatar/avocato.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/character/?sort=desc

[
  {
    "id": 47,
    "name": "Zargon Tukalishi",
    "status": "Deceased",
    "species": "Unknown",
    "gender": "Male",
    "hair": "None",
    "alias": [],
    "origin": "Yarno",
    "abilities": [],
    "img_url": "https://finalspaceapi.com/api/character/avatar/zargon_tukalishi.jpg"
  },
 ...
]

Limit the response

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

https://finalspaceapi.com/api/v0/character/?limit=3

[
  {
    "id": 1,
    "name": "Gary Goodspeed",
    "status": "Alive",
    "species": "Human",
    "gender": "Male",
    "hair": "Blonde",
    "alias": [
      "The Gary (by Lord Commander and Invictus)",
      "Thunder Bandit(code name)",
      "Star Dragon(new code name)",
      "Primate(By Clarence)",
      "The Captain (self-proclaimed)",
      "Mommy (by the Dewinter children)",
      "Jerry by (Quinn)",
      "Gerald (by Quinn and the S.A.M.E.S)",
      "Humanoid trash (by Avocato)",
      "Generic Blonde Guy (by Ash)",
      "No-Good Thief (by Avocato/Invictus)",
      "Little Bastard (by Sheryl)",
      "Larry Tumbleweed (by Tribore)",
      "Harry Hoodseed (by Tribore)",
      "Leslie (by Tribore)",
      "Barry (by Tribore)",
      "The Fool Who Died A Thousand Deaths (by Invictus)"
    ],
    "origin": "Earth",
    "abilities": [
      "Piloting",
      "Marksmanship",
      "Hand-to-hand combat",
      "Weapons: Blasters",
      "Weapons: Black hole gun (briefly)",
      "Weapons: Robot arm",
      "Weapons: Laser gun",
      "Weapons: Laser sword"
    ],
    "img_url": "https://finalspaceapi.com/api/character/avatar/gary_goodspeed.png"
  },
  {
    "id": 2,
    "name": "Mooncake",
    "status": "Unknown",
    "species": "Mooncake's Species",
    "gender": "None (referred to as male)",
    "hair": "None",
    "alias": [
      "Specimen E - 351",
      "Little Buddy",
      "Planet Destroyer",
      "Dude cake",
      "Little Guy",
      "The Key (by Lord Commander, Invictus, and Ash)",
      "The Missing Piece (by the Arachnitects)",
      "Homeslice (by Bolo)",
      "Booger Ball (by Kevin Van Newton)"
    ],
    "origin": "Outer space",
    "abilities": ["Hovering", "Firing Laser Beams", "Planetary Destruction"],
    "img_url": "https://finalspaceapi.com/api/character/avatar/mooncake.jpg"
  },
  {
    "id": 3,
    "name": "Quinn Ergon",
    "status": "Alive",
    "species": "Human",
    "gender": "Female",
    "hair": "Dark Brown",
    "alias": [
      "Nightfall(codename)",
      "Muy Bueno Super Spicy Lady (by Gary)",
      "Magnificent Goddess (by Biskit)"
    ],
    "origin": "Earth",
    "abilities": [
      "Astrophysicist",
      "Engineer",
      "Piloting",
      "Hand - to - hand Combat"
    ],
    "img_url": "https://finalspaceapi.com/api/character/avatar/quinn_ergon.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/character/?limit=3&sort=desc

[
  {
    "id": 47,
    "name": "Zargon Tukalishi",
    "status": "Deceased",
    "species": "Unknown",
    "gender": "Male",
    "hair": "None",
    "alias": [],
    "origin": "Yarno",
    "abilities": [],
    "img_url": "https://finalspaceapi.com/api/character/avatar/zargon_tukalishi.jpg"
  },
  {
    "id": 46,
    "name": "Werthrent",
    "status": "Deceased",
    "species": "Fire Snake",
    "gender": "Male",
    "hair": "None",
    "alias": ["Serpent God", "Snake God"],
    "origin": "Serepentis",
    "abilities": ["Telepathy", "Mind-breaking"],
    "img_url": "https://finalspaceapi.com/api/character/avatar/werthrent.jpg"
  },
  {
    "id": 45,
    "name": "Viro",
    "status": "Deceased",
    "species": "Cyborg",
    "gender": "Male",
    "hair": "None",
    "alias": [],
    "origin": "Unknown",
    "abilities": [],
    "img_url": "https://finalspaceapi.com/api/character/avatar/viro.jpg"
  }
]