Species

Discover the diverse species and alien races of the Star Wars universe with their characteristics and origins.

Endpoints

Get All Species

Retrieve all species

Request

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

Get Single Species

Get species by ID or slug

GET https://sw-next-api.vercel.app/api/v1/species/1
GET https://sw-next-api.vercel.app/api/v1/species/human

Response Example

{
  "entityId": 1,
  "id": "human",
  "name": "Human",
  "classification": "mammal",
  "designation": "sentient",
  "averageHeight": 180,       // Centimeters
  "skinColors": "caucasian, black, asian, hispanic",
  "hairColors": "blonde, brown, black, red",
  "eyeColors": "brown, blue, green, hazel, grey, amber",
  "averageLifespan": 120,     // Years
  "language": "Galactic Basic",
  "homeworld": {...},         // Origin planet (if known)
  "people": [...],            // Members of this species
  "films": [...]              // Films featuring this species
}

Common Queries

Find species by name

Request

GET https://sw-next-api.vercel.app/api/v1/species?search=wookiee

Available Features

Expansion

Expand: homeworld, people, films

Learn more →

Filtering

Filter by: classification, designation

Learn more →