Star Wars API — free mock REST API for testing

Characters, homeworlds and starships from a fictional space opera. Practice CRUD, Bearer auth, nested resources, pagination and optimistic concurrency.

The Star Wars API covers characters, planets and starships — three related collections with enough cross-references to make filtering interesting. It is a good first stop for anyone building a client that has to resolve ids across resources and page through more records than fit in a single response.

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

What you can practise here

• Filter characters by their home planet and check the empty-result case returns 200 with an empty list, not a 404.
• Walk every page of the starship collection and assert the total count matches what you actually collected.
• Create a starship, update it with the wrong ETag for a 412, then retry with the current one.
• Delete with a viewer token to see the 403 that read-only credentials produce.

planets

five worlds, one swamp

• GET /galaxy/v1/planets — List all planets
• GET /galaxy/v1/planets/{id} — Get one planet

characters

rebels, empire, and neutral parties

• GET /galaxy/v1/characters — List characters (paginated, filter by affiliation)
• GET /galaxy/v1/characters/{id} — Get one character
• GET /galaxy/v1/characters/{id}/homeworld — Get a character's homeworld (nested resource)
• POST /galaxy/v1/characters — Add a character (requires Bearer auth)
• PUT /galaxy/v1/characters/{id} — Update a character (requires Bearer auth)
• DELETE /galaxy/v1/characters/{id} — Remove a character (requires Bearer auth)

starships

freighters to capital ships

• GET /galaxy/v1/starships — List starships, filter by class
• GET /galaxy/v1/starships/random — A random starship
• GET /galaxy/v1/starships/{id} — Get one starship

Related APIs

• Friends API — Characters, episodes & quotes from the coffee-house gang.
• Movies API — QA-themed cinema. Sort, filter, rate.
• Harry Potter API — Houses, students & spells from a magic school.
• Sherlock Holmes API — Cases, suspects & clues from Baker Street.

All 39 mock REST APIs