Films

Access all Star Wars films with complete information about characters, planets, species, vehicles, and starships featured in each movie.

Endpoints

Get All Films

Retrieve all Star Wars films

Request

GET https://sw-next-api.vercel.app/api/v1/films

Get Single Film

Get film by ID or slug

GET https://sw-next-api.vercel.app/api/v1/films/1
GET https://sw-next-api.vercel.app/api/v1/films/a-new-hope

Response Example

{
  "entityId": 1,
  "id": "a-new-hope",
  "title": "A New Hope",
  "episode": 4,
  "opening_crawl": "It is a period of civil war...",
  "director": "George Lucas",
  "producers": ["Gary Kurtz", "Rick McCallum"],
  "release_date": "1977-05-25",
  "release_year": 1977,
  "characters": [
    {
      "entityId": 1,
      "id": "luke-skywalker",
      "name": "Luke Skywalker"
    }
  ],
  "planets": [...],
  "species": [...],
  "starships": [...],
  "vehicles": [...]
}

Common Queries

Get films in episode order

Request

GET https://sw-next-api.vercel.app/api/v1/films?sort=episode

Available Features

Expansion

Expand: characters, planets, species, starships, vehicles

Learn more →

Sorting

Sort by: episode, release_year, title

Learn more →