The Rick and Morty
API Documentation

Character schema

Key Type Description
id int The id of the character.
name string The name of the character.
status string The status of the character ('Alive', 'Dead' or 'unknown').
species string The species of the character.
type string The type or subspecies of the character.
gender string The gender of the character ('Female', 'Male', 'Genderless' or 'unknown').
origin object Name and link to the character's origin location.
location object Name and link to the character's last known location endpoint.
image string (url) Link to the character's image. All images are 300x300px and most are medium shots or portraits since they are intended to be used as avatars.
episode array (urls) List of episodes in which this character appeared.
url string (url) Link to the character's own URL endpoint.
created string Time at which the character was created in the database.

Get all characters

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

Get
https://rmapi.online/characters


[
{
"id": 703,
"name": "Rick Sanchez",
"status": "Alive",
"species": "Human",
"type": "",
"gender": "Male",
"last_location": "Citadel of Ricks",
"first_see": "Earth (C-137)",
"image": "https://rmapi.online/character/avatar/1.jpeg",
}
]


Get a single character

You can get a single character by adding the /id as a parameter: /character/2
Get
https://rmapi.online/character/706


[
{
"id": 706,
"name": "Beth Smith",
"status": "Alive",
"species": "Human",
"type": "",
"gender": "Female",
"last_location": "Earth (Replacement Dimension)",
"first_see": "Earth (Replacement Dimension)",
"image": "https://rmapi.online/character/avatar/4.jpeg",
}
]


Get multiple characters

You can get multiple characters by adding an array of /id /multiCharacters/1,2,3
Get
https://rmapi.online/multiCharacters/703,704


[
{
"id": 703,
"name": "Rick Sanchez",
"status": "Alive",
"species": "Human",
"type": "",
"gender": "Male",
"last_location": "Citadel of Ricks",
"first_see": "Earth (C-137)",
"image": "https://rmapi.online/character/avatar/1.jpeg",
} ,
{
"id": 718,
"name": "Amish Cyborg",
"status": "Dead",
"species": "Alien",
"type": "",
"gender": "Male",
"last_location": "Earth (Replacement Dimension)",
"first_see": "unknown",
"image": "https://rmapi.online/character/avatar/16.jpeg",
} ,
]

Filter characters

You can also include filters in the URL by including additional query parameters. To start filtering add a ? followed by the query < query>=< value> If you want to chain several queries in the same call, use & followed by the query.
Get
https://rmapi.online/filterCharacter/?name=Annie&status=alive


[
{
"id": 703,
"name": "Rick Sanchez",
"status": "Alive",
"species": "Human",
"type": "",
"gender": "Male",
"last_location": "Citadel of Ricks",
"first_see": "Earth (C-137)",
"image": "https://rmapi.online/character/avatar/1.jpeg",
} ,
]


Location schema

Key Type Description
id int The id of the character.
name string The name of the character.
type string The type or subspecies of the character.
dimension string The dimension in which the location is located.
residents array (urls) List of character who have been last seen in the location.
url string (url) Link to the location's own endpoint.

Get all locations

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

Get
https://rmapi.online/location


[
{
"location_id": 1,
"name": "Earth (C-137)",
"type": "Planet",
"dimension": "Dimension C-137",
"residents": " [
https://rmapi.online/character/38,
https://rmapi.online/character/45,
// ...
]",
"url": "https://rmapi.online/location/1",
}
]


Get a single location

You can get a single location by adding the id as a parameter: /location/3

Get
https://rmapi.online/location/1


[
{
"location_id": 1,
"name": "Earth (C-137)",
"type": "Planet",
"dimension": "Dimension C-137",
"residents": " [
https://rmapi.online/character/38,
https://rmapi.online/character/45,
// ...
"url": "https://rmapi.online/location/1",
} ,
{
"location_id": 16,
"name": "St. Gloopy Noops Hospital",
"type": "Space station",
"dimension": "unknown",
"residents": " [
https://rmapi.online/character/105,
https://rmapi.online/character/263,
// ...
"url": "https://rmapi.online/location/1",
} ,
]

Get multiple location

You can get multiple location by adding an array of id as parameter: /multiLocation/1,2

Get
https://rmapi.online/multiLocation/1,2


[
{
"location_id": 1,
"name": "Earth (C-137)",
"type": "Planet",
"dimension": "Dimension C-137",
"residents": " [
https://rmapi.online/character/38,
https://rmapi.online/character/45,
// ... "url": "https://rmapi.online/episode/1",

}
{ "episode_id": 2,
"name": "Abadango",
"air_date": "Cluster",
"episode": "unknown",
"characters": " [
https://rmapi.online/character/6,
https://rmapi.online/character/4,
// ... "url": "https://rmapi.online/episode/2",

}
]


Filter locations


  • name :filter by the given name.
  • type :filter by the given type.
  • dimension :filter by the given dimension.
    • If you want to know how to use queries, check here

Episode schema

Key Type Description
episode_id int The id of the episode.
name string The name of the episode.
air_date string The air date of the episode.
episode string The code of the episode.
characters array (urls) List of characters who have been seen in the episode.
url string (url) Link to the episode's own endpoint.

Get all episodes

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

Get
https://rmapi.online/episode


[
{
"episode_id": 2,
"name": "Lawnmower Dog",
"air_date": "December 9, 2013",
"episode": "S01E02",
"characters": " [
https://rmapi.online/character/46,
https://rmapi.online/character/63,
// ... "url": "https://rmapi.online/episode/2",

}
]


Get a single episode

You can get a single episode by adding the id as a parameter: /episode/5 endpoint.

Get
https://rmapi.online/episode/5


[
{
"episode_id": 5,
"name": "Meeseeks and Destroy",
"air_date": "January 20, 2014",
"episode": "S01E05",
"characters": " [
https://rmapi.online/character/2,
https://rmapi.online/character/38,
// ... "url": "https://rmapi.online/episode/5",

}
]


Get multiple episodes

You can get multiple episodes by adding an array of id as parameter: /multiEpisode/1,2,3

Get
https://rmapi.online/multiEpisode/14,16


[
{
"episode_id": 14,
"name": "Auto Erotic Assimilation",
"air_date": "August 9, 2015",
"episode": "S02E03",
"characters": " [
https://rmapi.online/character/336,
https://rmapi.online/character/355,
// ... "url": "https://rmapi.online/episode/14",

}
{ "episode_id": 16,
"name": "Get Schwifty",
"air_date": "August 23, 2015",
"episode": "S02E05",
"characters": " [
https://rmapi.online/character/1,
https://rmapi.online/character/4,
// ... "url": "https://rmapi.online/episode/16",

}
]




    Filter episodes

    Available parameters:
  • name :filter by the given name.
  • episode :filter by the given episode code.
    • If you want to know how to use queries, check here