Episode
There is a total of 51
episodes sorted by id (which is of course the order of the episodes)
Episode schema
Key | Type | Description |
---|---|---|
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. |
created | string | Time at which the episode was created in the database. |
Get all episodes
You can access the list of episodes by using the /episode
endpoint.
GET https://therickandmortyapi.vercel.app/api/episode
{
"info": {
"count": 51,
"pages": 3,
"next": "https://therickandmortyapi.vercel.app/api/episode?page=2",
"prev": null
},
"results": [
{
"id": 1,
"name": "Pilot",
"air_date": "December 2, 2013",
"episode": "S01E01",
"characters": [
"https://therickandmortyapi.vercel.app/api/character/1",
"https://therickandmortyapi.vercel.app/api/character/2"
// ...
],
"url": "https://therickandmortyapi.vercel.app/api/episode/1",
"created": "2017-11-10T07:56:33.798Z"
}
// ...
]
}
Get a single episode
You can get a single episode by adding the id
as a parameter: /episode/41
GET https://therickandmortyapi.vercel.app/api/episode/41
{
"id": 41,
"name": "Star Mort: Rickturn of the Jerri",
"air_date": "May 31, 2020",
"episode": "S04E10",
"characters": [
"https://therickandmortyapi.vercel.app/api/character/1",
"https://therickandmortyapi.vercel.app/api/character/2"
// ...
],
"url": "https://therickandmortyapi.vercel.app/api/episode/41",
"created": "2020-08-06T00:51:52.079Z"
}
Get multiple episodes
You can get multiple episodes by adding an array of ids
as parameter: /episode/1,2,3
GET https://therickandmortyapi.vercel.app/api/episode/8,39
[
{
"id": 8,
"name": "Rixty Minutes",
"air_date": "March 17, 2014",
"episode": "S01E08",
"characters": [
"https://therickandmortyapi.vercel.app/api/character/1",
"https://therickandmortyapi.vercel.app/api/character/2"
// ...
],
"url": "https://therickandmortyapi.vercel.app/api/episode/8",
"created": "2017-11-10T07:56:34.543Z"
},
{
"id": 39,
"name": "The Vat of Acid Episode",
"air_date": "May 17, 2020",
"episode": "S04E08",
"characters": [
"https://therickandmortyapi.vercel.app/api/character/1",
"https://therickandmortyapi.vercel.app/api/character/2"
// ...
],
"url": "https://therickandmortyapi.vercel.app/api/episode/39",
"created": "2020-08-06T00:51:07.419Z"
}
]
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 the Query Filters Guide.