Skip to main content

Character

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

Character schema#

KeyTypeDescription
idintThe id of the character (starting from 1).
namestringThe name of the character.
statusstringThe status of the character.
speciesstringThe species of the character.
genderstringThe gender of the character.
hairstringThe hair color of the character.
originobjectName of the character's origin location.
abilitiesarrayDifferent abilities of character.
aliasarrayDifferent names of character.
img_urlstring (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"  }]