{"openapi":"3.1.0","info":{"title":"Rick and Morty API","version":"1.0.0","description":"The Rick and Morty universe as an API — every character, location and episode from the show. Look up a character by id or search and filter the roster by name, status (alive, dead, unknown), species, type and gender (e.g. all living Mortys), browse locations by name, type and dimension, or pull episodes by name or episode code (e.g. S03E07 → The Ricklantis Mixup). Each character carries status, species, origin and last-known location, episode appearances and a portrait; locations carry their type and dimension; episodes carry the air date and cast size. Backed by the open rickandmortyapi.com dataset. Ideal for fan sites, trivia and quiz games, Discord bots, learning projects and any Rick and Morty app.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/rickandmorty-api","description":"oanor gateway"}],"tags":[{"name":"Rick and Morty"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/character":{"get":{"operationId":"get_v1_character","tags":["Rick and Morty"],"summary":"A character by id or filtered search","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Character id, e.g. 1 (Rick Sanchez)","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. morty","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"alive | dead | unknown","schema":{"type":"string"}},{"name":"species","in":"query","required":false,"description":"Species, e.g. Human","schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"description":"female | male | genderless | unknown","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"character":{"id":1,"url":"https://rickandmortyapi.com/api/character/1","name":"Rick Sanchez","image":"https://rickandmortyapi.com/api/character/avatar/1.jpeg","gender":"Male","origin":"Earth (C-137)","status":"Alive","species":"Human","location":"Citadel of Ricks","episode_count":51}},"meta":{"timestamp":"2026-06-01T00:04:35.151Z","request_id":"5ee22bcd-a297-408d-b460-a83e5e45dee0"},"status":"ok","message":"Character retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/episode":{"get":{"operationId":"get_v1_episode","tags":["Rick and Morty"],"summary":"An episode by id or filtered search","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Episode id, e.g. 28","schema":{"type":"string"},"example":"28"},{"name":"name","in":"query","required":false,"description":"Name search","schema":{"type":"string"}},{"name":"episode","in":"query","required":false,"description":"Episode code, e.g. S03E07","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"episode":{"id":28,"url":"https://rickandmortyapi.com/api/episode/28","name":"The Ricklantis Mixup","episode":"S03E07","air_date":"September 10, 2017","character_count":65}},"meta":{"timestamp":"2026-06-01T00:04:35.241Z","request_id":"7eab8110-fff6-4939-8772-f80c3d4c541e"},"status":"ok","message":"Episode retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/location":{"get":{"operationId":"get_v1_location","tags":["Rick and Morty"],"summary":"A location by id or filtered search","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Location id, e.g. 3 (Citadel of Ricks)","schema":{"type":"string"},"example":"3"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. earth","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Type, e.g. Planet","schema":{"type":"string"}},{"name":"dimension","in":"query","required":false,"description":"Dimension search","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"location":{"id":3,"url":"https://rickandmortyapi.com/api/location/3","name":"Citadel of Ricks","type":"Space station","dimension":"unknown","resident_count":101}},"meta":{"timestamp":"2026-06-01T00:04:35.307Z","request_id":"d94f2779-6009-4577-a93a-d9b9cc8ec2d6"},"status":"ok","message":"Location retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Filters & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Rick and Morty universe. /v1/character = a character by id or search/filter (name, status, species, type, gender); /v1/location = a location by id or filter (name, type, dimension); /v1/episode = an episode by id or filter (name, episode code). Add page= to paginate searches.","source":"rickandmortyapi.com","filters":{"episode":["name","episode (e.g. S03E07)"],"location":["name","type","dimension"],"character":["name","status (alive|dead|unknown)","species","type","gender"]},"endpoints":["/v1/character","/v1/location","/v1/episode","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:35.381Z","request_id":"960561da-fa1d-49a2-87e4-2335e2d2750c"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":330,"monthly_call_quota":130000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1010,"monthly_call_quota":640000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3140,"monthly_call_quota":2700000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/rickandmorty-api"}