canonical: https://jentic.com/apis/rickandmortyapi.com/rickandmortyapi

# Rick and Morty API

Jentic publishes the only available OpenAPI specification for Rick and Morty API, keeping it validated and agent-ready. The Rick and Morty API serves the characters, locations, and episodes of the Rick and Morty TV show as public, read-only JSON with no authentication. Characters can be filtered by name, status, species, type, and gender, locations by name, type, and dimension, and episodes by name or episode code such as S01E01. Each resource can be fetched by a single id or by a comma-separated list of ids in one request, and list results are paged with a page parameter.

## For AI agents

Look up Rick and Morty characters, locations, and episodes by id or filter, such as characters by status and species or episodes by code, with no credential needed.

## Scope

Does not stream episodes, host video, or cover other TV shows. Use for reading Rick and Morty character, location, and episode data only.

## Capabilities

- Search characters by name, status, species, type, and gender, with paged results
- Fetch one character by id, or several at once with a comma-separated list of ids
- Find locations by name, type, or dimension and read who lives there
- Look up episodes by name or by episode code such as S01E01
- Batch-fetch several episodes or locations in a single request by id list

## Use cases

### Agent tutorial and test target with no credential

Developers building or testing an agent need a stable, public API that returns realistic nested data without signup. Through Jentic the agent searches by intent, such as 'find a Rick and Morty character by name', gets the listCharacters operation with its input schema, and calls it without any key to configure. Because the data is read-only, a test run cannot change anything upstream.

Example prompt: Call GET /character with name 'rick' and status 'alive', then return the name, species, and origin of each character on the first page

### Fan wiki and trivia app data

Fan sites and trivia games need character, episode, and location facts they can trust. GET /character returns characters with status, species, gender, origin, location, and the episodes they appear in, while GET `/episode/{id}` returns air date, episode code, and the characters in it. The comma-separated id endpoints such as GET `/character/{ids}` load a whole cast list in one call.

Example prompt: Fetch GET /episode with episode 'S01E01', collect the character ids from its characters list, and load them in one call via GET `/character/{ids}`

### Teaching REST pagination and filtering

Courses on REST APIs use the Rick and Morty API because it shows paging and query filters on small, friendly data. List endpoints accept a page parameter and return an info block with counts and next and previous links, and filters such as gender on characters or dimension on locations narrow results. Students can practice with no account or key.

Example prompt: Page through GET /location from page 1 until there is no next page and count how many locations have type 'Planet'

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/character` | List characters with filters |
| GET | `/character/{id}` | Get a character by id |
| GET | `/character/{ids}` | Get multiple characters by ids |
| GET | `/location` | List locations with filters |
| GET | `/episode` | List episodes with filters |
| GET | `/episode/{id}` | Get an episode by id |

## Key resources

- **Characters** — List and filter characters by name, status, species, type, and gender, or fetch by one or many ids
- **Locations** — List and filter locations by name, type, and dimension, or fetch by one or many ids
- **Episodes** — List and filter episodes by name and episode code, or fetch by one or many ids

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 64 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 73 / 100
  - Developer Experience & Jentic Compatibility: 58 / 100
  - AI-Readiness & Agent Experience: 43 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 68 / 100
- **View full report:** https://jentic.com/apis/rickandmortyapi.com/rickandmortyapi/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Rick and Morty API by hand means following its page-based list paging and building comma-separated id paths for batch lookups. Through Jentic you install once, import the Rick and Morty API from the API Directory, and your agent calls it with no credential to configure.
- **Permission scoping:** Every operation is a read, and the character, location, and episode ids sit in the URL path, so a rule can pin your agent to the lookups it needs, such as character search and character by id, and withhold the rest. None of the operations change data.
- **Credential handling:** The Rick and Morty API serves public data and needs no credential, so there is no secret for your agent to see or mishandle. Calls still run through your own Jentic One instance, which logs them.
- **Discovery method:** Agents search Jentic by intent such as 'find a Rick and Morty character by name' or 'get an episode by code', and Jentic returns the matching operation with its input schema, including enum filters like status and gender.

## Related APIs

- **SWAPI** — Public Star Wars data API with people, planets, films, and starships
- **PokeAPI** — Large public Pokemon data API, often used for the same tutorial and testing jobs
- **TMDB API** — Film and TV metadata such as cast, ratings, and images

## FAQ

### Why is there no official OpenAPI spec for Rick and Morty API?

The Rick and Morty API does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Rick and Morty API via structured tooling. It is validated against the live API and kept up to date. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### What authentication does the Rick and Morty API use?

None. The spec declares no security schemes, and the API is public: every operation is a GET that needs no key, token, or account. Through Jentic there is nothing to configure before your agent calls it.

### Can I fetch several characters in one request with the Rick and Morty API?

Yes. GET `/character/{ids}` takes a comma-separated list of character ids, such as 1,2,3, and returns them together. The same pattern works for locations with GET `/location/{ids}` and for episodes with GET `/episode/{ids}.`

### What are the rate limits for the Rick and Morty API?

The OpenAPI spec does not specify rate limits. Check the official documentation at https://rickandmortyapi.com/documentation for current guidance, and cache results since the data rarely changes.

### Is there a Rick and Morty API MCP server?

You don't need an MCP server to give your agent the Rick and Morty API. Jentic connects it directly from the API Directory: import it and your agent calls the character, location, and episode operations on demand, without another server's tool definitions in its context.

### Can I limit what my agent is allowed to do with the Rick and Morty API?

Yes. Write a rule that allows only GET /character and GET `/character/{id}` for a character-lookup agent, and it can search and read characters but not page through locations or episodes. Every call it makes is logged, which helps when you use the API as a test target.

### How do I filter Rick and Morty characters by status?

Pass the status query parameter to GET /character with one of alive, dead, or unknown. You can combine it with name, species, type, and gender, and step through results with page.
