Character

This is the documentation for the /character endpoint. There are currently 40 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.

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)",
"Thunder Bandit(code name)",
"Star Dragon(new code name)",
"Primate(By Clarence)"
],
"origin": "Earth",
"abilities": [
"Piloting",
"Marksmanship"
],
"img_url": "https://finalspaceapi.com/api/character/avatar/gary_goodspeed.jpg"
},
...
]

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"],
"origin": "Unknown",
"abilities": ["Combat", "Surgery"],
"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": 40,
"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)",
"Thunder Bandit(code name)",
"Star Dragon(new code name)",
"Primate(By Clarence)"
],
"origin": "Earth",
"abilities": ["Piloting", "Marksmanship"],
"img_url": "https://finalspaceapi.com/api/character/avatar/gary_goodspeed.jpg"
},
{
"id": 2,
"name": "Mooncake",
"status": "Alive",
"species": "Mooncake's Species",
"gender": "Male",
"hair": "None",
"alias": [
"Specimen E - 351",
"Little Buddy",
"Planet Destroyer",
"Dude cake",
"Little Guy"
],
"origin": "Created when John Goodspeed used an Anti-matter bomb to close a breach to Final Space.",
"abilities": ["Hovering", "Firing Laser Beams", "Planet 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)"],
"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": 40,
"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": 39,
"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": 38,
"name": "Viro",
"status": "Deceased",
"species": "Cyborg",
"gender": "Male",
"hair": "None",
"alias": [],
"origin": "Unknown",
"abilities": [],
"img_url": "https://finalspaceapi.com/api/character/avatar/viro.jpg"
}
]
Last updated on by Ashutosh