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.

Example request and response

GET https://funapi.dev/api/galaxy/v1/planets — List all planets. No token, no signup:

curl -i https://funapi.dev/api/galaxy/v1/planets

answers 200 OK with:

{
  "total": 5,
  "data": [
    {
      "id": 1,
      "name": "Tatooine",
      "climate": "arid",
      "population": 200000
    },
    {
      "id": 2,
      "name": "Hoth",
      "climate": "frozen",
      "population": 0
    },
    {
      "id": 3,
      "name": "Dagobah",
      "climate": "murky",
      "population": 0
    },
    {
      "id": 4,
      "name": "Coruscant",
      "climate": "temperate",
      "population": 1000000000
    },
    {
      "id": 5,
      "name": "Endor",
      "climate": "temperate",
      "population": 30000000
    }
  ]
}

Open and run this endpoint

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 · Responds with 200 Link to this endpoint
• GET /galaxy/v1/planets/{id} — Get one planet · Responds with 200 404 Link to this endpoint

characters

rebels, empire, and neutral parties

• GET /galaxy/v1/characters — List characters (paginated, filter by affiliation) · Responds with 200 400 404 Link to this endpoint
• GET /galaxy/v1/characters/{id} — Get one character · Responds with 200 404 Link to this endpoint
• GET /galaxy/v1/characters/{id}/homeworld — Get a character's homeworld (nested resource) · Responds with 200 404 Link to this endpoint
• POST /galaxy/v1/characters — Add a character (requires Bearer auth) · Responds with 201 400 401 Link to this endpoint
• PUT /galaxy/v1/characters/{id} — Update a character (requires Bearer auth) · Responds with 200 400 401 404 412 Link to this endpoint
• DELETE /galaxy/v1/characters/{id} — Remove a character (requires Bearer auth) · Responds with 204 401 403 404 412 Link to this endpoint

starships

freighters to capital ships

• GET /galaxy/v1/starships — List starships, filter by class · Responds with 200 Link to this endpoint
• GET /galaxy/v1/starships/random — A random starship · Responds with 200 Link to this endpoint
• GET /galaxy/v1/starships/{id} — Get one starship · Responds with 200 404 Link to this endpoint

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

Use this response elsewhere

• JSON to TypeScript on fundata.dev — an interface for this response
• JSON to Zod on fundata.dev — a runtime validator for it
• mock API data on fundata.dev — thousands of records of the same shape for your own fixtures

How this Star Wars API differs from SWAPI

Unofficial and fan-made. The Star Wars API is a practice API that borrows a theme; it is not affiliated with, sponsored or endorsed by the owners of the names it references, which belong to them. Every record it returns is test data for exercising HTTP behaviour, not an authoritative source on the subject.

Last updated 2 October 2026