Harry Potter API — free mock REST API for testing

Houses, students and spells from a fictional wizarding school. Practice CRUD, Bearer auth, nested filtering by house, pagination and optimistic concurrency.

The Harry Potter API models a magic school: four houses with point totals, students sorted into them, and a spell book. Points move between houses, which makes it a natural fit for practising the read-modify-write cycle — and for seeing what happens when two clients try it at the same time.

Base URL: https://funapi.dev/api/wizarding/v1 · 10 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.

What you can practise here

• Award house points from two concurrent requests and use If-Match to make one of them lose with a 412.
• Sort a student into a house that does not exist and read the 404 rather than a silent success.
• Page through the spell list and confirm your client handles the final, partially-full page correctly.
• Try a protected write with no Authorization header at all to see the bare 401.

houses

four houses, four elements

• GET /wizarding/v1/houses — List all houses
• GET /wizarding/v1/houses/{id} — Get one house
• POST /wizarding/v1/sorting-hat — The Sorting Hat assigns you a house (stateless, random)

students

sorted, patronus and all

• GET /wizarding/v1/students — List students (paginated, filter by house)
• GET /wizarding/v1/students/{id} — Get one student
• POST /wizarding/v1/students — Enroll a student (requires Bearer auth)
• PUT /wizarding/v1/students/{id} — Update a student (requires Bearer auth)
• DELETE /wizarding/v1/students/{id} — Expel a student (requires Bearer auth)

spells

charms, jinxes, and one unforgivable

• GET /wizarding/v1/spells — List spells, filter by type
• GET /wizarding/v1/spells/random — A random spell

Related APIs

• Friends API — Characters, episodes & quotes from the coffee-house gang.
• Movies API — QA-themed cinema. Sort, filter, rate.
• Star Wars API — Characters, planets & starships from a galaxy far away.
• Sherlock Holmes API — Cases, suspects & clues from Baker Street.

All 39 mock REST APIs