{"openapi":"3.1.0","info":{"title":"Harry Potter API","version":"1.0.0","description":"The Wizarding World of Harry Potter as an API, powered by the open PotterDB. Search hundreds of characters by name and Hogwarts house (e.g. Harry Potter → Gryffindor, Stag patronus, half-blood, with species, wand, family and titles), browse the spell book (incantations, effects, light colour and casting hand — e.g. the Patronus Charm \"Expecto Patronum\"), the seven novels (author, pages, release date, dedication and summary), and the potions (ingredients, effect, difficulty and side-effects — e.g. Polyjuice Potion). Filter and paginate, or fetch any item by its slug. Ideal for fan sites, trivia and quiz games, Sorting-Hat and house apps, Discord bots and any Harry Potter project.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/harrypotter-api","description":"oanor gateway"}],"tags":[{"name":"Wizarding World"},{"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/book":{"get":{"operationId":"get_v1_book","tags":["Wizarding World"],"summary":"The seven books (or one by id)","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Book slug for a single book","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"books":[{"id":"harry-potter-and-the-philosopher-s-stone","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Philosopher's_Stone","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-1.jpg","pages":223,"title":"Harry Potter and the Philosopher's Stone","author":"J. K. Rowling","summary":"Harry Potter has never even heard of Hogwarts when the letters start dropping on the doormat at number four, Privet Drive. Addressed in green ink on yellowish parchment with a purple seal, they are swiftly confiscated by his grisly aunt and uncle. Then, on Harry's eleventh birthday, a great beetle-eyed giant of a man called Rubeus Hagrid bursts in with some astonishing news: Harry Potter is a wizard, and he has a place at Hogwarts School of Witchcraft and Wizardry. An incredible adventure is about to begin!","dedication":"For Jessica, who loves stories, for Anne, who loved them too, and for Di, who heard this one first","release_date":"1997-06-26"},{"id":"harry-potter-and-the-chamber-of-secrets","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Chamber_of_Secrets","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-2.jpg","pages":251,"title":"Harry Potter and the Chamber of Secrets","author":"J. K. Rowling","summary":"Harry Potter's summer has included the worst birthday ever, doomy warnings from a house-elf called Dobby, and rescue from the Dursleys by his friend Ron Weasley in a magical flying car! Back at Hogwarts School of Witchcraft And Wizardry for his second year, Harry hears strange whispers echo through empty corridors – and then the attacks start. Students are found as though turned to stone... Dobby's sinister predictions seem to be coming true.","dedication":"For Séan P. F. Harris, getaway driver and foul-weather friend","release_date":"1998-07-02"},{"id":"harry-potter-and-the-prisoner-of-azkaban","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Prisoner_of_Azkaban","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-3.jpg","pages":317,"title":"Harry Potter and the Prisoner of Azkaban","author":"J. K. Rowling","summary":"When the Knight Bus crashes through the darkness and screeches to a halt in front of him, it's the start of another far from ordinary year at Hogwarts for Harry Potter. Sirius Black, escaped mass-murderer and follower of Lord Voldemort, is on the run – and they say he is coming after Harry. In his first ever Divination class, Professor Trelawney sees an omen of death in Harry's tea leaves... But perhaps most terrifying of all are the Dementors patrolling the school grounds, with their soul-sucking kiss.","dedication":"To Jill Prewett and Aine Kiely, the Godmothers of Swing","release_date":"1999-07-08"},{"id":"harry-potter-and-the-goblet-of-fire","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Goblet_of_Fire","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-4.jpg","pages":636,"title":"Harry Potter and the Goblet of Fire","author":"J. K. Rowling","summary":"The Triwizard Tournament is to be held at Hogwarts. Only wizards who are over seventeen are allowed to enter – but that doesn't stop Harry dreaming that he will win the competition. Then at Hallowe'en, when the Goblet of Fire makes its selection, Harry is amazed to find his name is one of those that the magical cup picks out. He will face death-defying tasks, dragons and Dark wizards, but with the help of his best friends, Ron and Hermione, he might just make it through – alive!","dedication":"To Peter Rowling, in memory of Mr Ridley and to Susan Sladden, who helped Harry out of his cupboard","release_date":"2000-07-08"},{"id":"harry-potter-and-the-order-of-the-phoenix","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Order_of_the_Phoenix","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-5.jpg","pages":766,"title":"Harry Potter and the Order of the Phoenix","author":"J. K. Rowling","summary":"Dark times have come to Hogwarts. After the Dementors' attack on his cousin Dudley, Harry Potter knows that Voldemort will stop at nothing to find him. There are many who deny the Dark Lord's return, but Harry is not alone: a secret Order gathers at Grimmauld Place to fight against the Dark forces. Harry must allow Professor Snape to teach him how to protect himself from Voldemort's savage assaults on his mind. But they are growing stronger by the day and Harry is running out of time.","dedication":"To Neil, Jessica and David, who make my world magical","release_date":"2003-06-21"},{"id":"harry-potter-and-the-half-blood-prince","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Half-Blood_Prince","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-6.jpg","pages":607,"title":"Harry Potter and the Half-Blood Prince","author":"J. K. Rowling","summary":"When Dumbledore arrives at Privet Drive one summer night to collect Harry Potter, his wand hand is blackened and shrivelled, but he does not reveal why. Secrets and suspicion are spreading through the wizarding world, and Hogwarts itself is not safe. Harry is convinced that Malfoy bears the Dark Mark: there is a Death Eater amongst them. Harry will need powerful magic and true friends as he explores Voldemort's darkest secrets, and Dumbledore prepares him to face his destiny.","dedication":"To Mackenzie, My beautiful daughter, I dedicate Her ink-and-paper twin.","release_date":"2005-07-16"},{"id":"harry-potter-and-the-deathly-hallows","wiki":"https://harrypotter.fandom.com/wiki/Harry_Potter_and_the_Deathly_Hallows","cover":"https://www.wizardingworld.com/images/products/books/UK/rectangle-7.jpg","pages":610,"title":"Harry Potter and the Deathly Hallows","author":"J. K. Rowling","summary":"As he climbs into the sidecar of Hagrid's motorbike and takes to the skies, leaving Privet Drive for the last time, Harry Potter knows that Lord Voldemort and the Death Eaters are not far behind. The protective charm that has kept Harry safe until now is broken, but he cannot keep hiding. The Dark Lord is breathing fear into everything Harry loves, and to stop him Harry will have to find and destroy the remaining Horcruxes. The final battle must begin – Harry must stand and face his enemy.","dedication":"To Neil, To Jessica, To David, To Kenzie, To Di, To Anne, And to You If you have stuck with Harry until the very end.","release_date":"2007-07-21"}],"count":7},"meta":{"timestamp":"2026-06-01T00:04:31.442Z","request_id":"de6fdea2-c3f5-42d6-87b3-ecc45db749f5"},"status":"ok","message":"Book 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/character":{"get":{"operationId":"get_v1_character","tags":["Wizarding World"],"summary":"Search characters by name / house","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Name search, e.g. Harry Potter","schema":{"type":"string"},"example":"Harry Potter"},{"name":"house","in":"query","required":false,"description":"Gryffindor | Slytherin | Hufflepuff | Ravenclaw","schema":{"type":"string"}},{"name":"id","in":"query","required":false,"description":"Slug for a single character, e.g. harry-james-potter","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"pageSize","in":"query","required":false,"description":"Page size (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":2,"total":2,"page_size":20,"characters":[{"id":"unidentified-gryffindor-fifth-year-who-congratulated-harry-potter","born":"Between 1 September 1976 and 31 August 1977","jobs":[],"name":"Gryffindor fifth-year who congratulated Harry Potter","wiki":"https://harrypotter.fandom.com/wiki/Unidentified_Gryffindor_fifth-year_who_congratulated_Harry_Potter","house":"Gryffindor","wands":[],"titles":[],"species":"Human","alias_names":[],"nationality":"British or Irish","family_members":[]},{"id":"unidentified-death-eater-who-was-stunned-by-harry-potter","jobs":[],"name":"Unidentified Death Eater who was Stunned by Harry Potter","wiki":"https://harrypotter.fandom.com/wiki/Unidentified_Death_Eater_who_was_Stunned_by_Harry_Potter","wands":[],"gender":"Male","titles":[],"species":"Human","patronus":"None","hair_color":"Black","alias_names":[],"blood_status":"Pure-blood or half-blood","family_members":[]}]},"meta":{"timestamp":"2026-06-01T00:04:31.551Z","request_id":"2b89200d-da7a-45fd-a2c1-b5b463af24b1"},"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/potion":{"get":{"operationId":"get_v1_potion","tags":["Wizarding World"],"summary":"Search potions","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Potion name, e.g. Polyjuice","schema":{"type":"string"},"example":"Polyjuice"},{"name":"id","in":"query","required":false,"description":"Potion slug","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"},{"name":"pageSize","in":"query","required":false,"description":"Page size (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":1,"total":1,"potions":[{"id":"polyjuice-potion","name":"Polyjuice Potion","wiki":"https://harrypotter.fandom.com/wiki/Polyjuice_Potion","image":"https://static.wikia.nocookie.net/harrypotter/images/1/1b/B2C12M2_Polyjuice_Potion_ready.jpg","effect":"Allowed a human drinker to temporarily assume the form of another person","difficulty":"Advanced","ingredients":"Lacewing flies (stewed for 21 days), Leeches, Powdered bicorn horn, Knotgrass, Fluxweed (picked at full moon), Shredded boomslang skin, A bit of the person one wanted to turn into (typically hair or toenails), Standard potioning water","side_effects":"Attempts to transform into animals or part-humans would not reverse automatically","characteristics":"Thick and mud-like, Bubbles slowly, Taste and colour varied depending on the person being turned into"}],"page_size":20},"meta":{"timestamp":"2026-06-01T00:04:31.648Z","request_id":"5302d4a0-3b26-46fc-8dc5-b8ff40171c9f"},"status":"ok","message":"Potion 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/spell":{"get":{"operationId":"get_v1_spell","tags":["Wizarding World"],"summary":"Search spells","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Spell name, e.g. Patronus","schema":{"type":"string"},"example":"Patronus"},{"name":"id","in":"query","required":false,"description":"Spell slug","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"},{"name":"pageSize","in":"query","required":false,"description":"Page size (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":1,"total":1,"spells":[{"id":"patronus-charm","name":"Patronus Charm","wiki":"https://harrypotter.fandom.com/wiki/Patronus_Charm","image":"https://static.wikia.nocookie.net/harrypotter/images/f/fe/Patronus_PM_SilverStagPatronus_MomentIllust.jpg","light":"Silver","effect":"Conjured a spirit guardian","category":"Charm","incantation":"Expecto Patronum(ex-PEK-toh pa-TRO-num)"}],"page_size":20},"meta":{"timestamp":"2026-06-01T00:04:31.737Z","request_id":"07b97023-bf8c-4075-ae6b-564799b46ab8"},"status":"ok","message":"Spell 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":"Houses & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Wizarding World of Harry Potter. /v1/character = search characters by name (and house=Gryffindor|Slytherin|Hufflepuff|Ravenclaw) or fetch by id — with species, blood status, patronus, wand, family and more; /v1/spell = search spells (incantation, effect, light); /v1/book = the seven books; /v1/potion = search potions (ingredients, effect, difficulty). Add page & pageSize to paginate; ids are lowercase-hyphenated slugs.","houses":["Gryffindor","Slytherin","Hufflepuff","Ravenclaw"],"source":"PotterDB (api.potterdb.com)","endpoints":["/v1/character","/v1/spell","/v1/book","/v1/potion","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:31.802Z","request_id":"8def8def-4ed6-4af9-9329-2c8ebd2d385b"},"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":11000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":300,"monthly_call_quota":160000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1000,"monthly_call_quota":700000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3120,"monthly_call_quota":2850000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/harrypotter-api"}