Star Wars API · Schema

Person

A person or character within the Star Wars universe

Star WarsScience FictionEntertainmentFilmsCharactersPlanetsStarshipsVehiclesSpeciesOpen Source

Properties

Name Type Description
name string The name of this person
height string The height of the person in centimeters
mass string The mass of the person in kilograms
hair_color string The hair color of this person. Will be 'unknown' if not known or 'n/a' if the person does not have hair
skin_color string The skin color of this person
eye_color string The eye color of this person. Will be 'unknown' if not known or 'n/a' if the person does not have eyes
birth_year string The birth year of the person, using the in-universe standard of BBY or ABY - Before the Battle of Yavin or After the Battle of Yavin
gender string The gender of this person. Either 'male', 'female' or 'unknown', 'n/a' if the person does not have a gender
homeworld string URL of the planet resource that this person was born on
films array URLs of film resources this person has been in
species array URLs of species resources that this person belongs to
vehicles array URLs of vehicle resources that this person has piloted
starships array URLs of starship resources that this person has piloted
created string ISO 8601 date-time when this resource was created
edited string ISO 8601 date-time when this resource was last edited
url string The hypermedia URL of this resource
View JSON Schema on GitHub

JSON Schema

person.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/star-wars/main/json-schema/person.json",
  "title": "Person",
  "description": "A person or character within the Star Wars universe",
  "type": "object",
  "required": [
    "name",
    "height",
    "mass",
    "hair_color",
    "skin_color",
    "eye_color",
    "birth_year",
    "gender",
    "homeworld",
    "films",
    "species",
    "vehicles",
    "starships",
    "created",
    "edited",
    "url"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The name of this person"
    },
    "height": {
      "type": "string",
      "description": "The height of the person in centimeters"
    },
    "mass": {
      "type": "string",
      "description": "The mass of the person in kilograms"
    },
    "hair_color": {
      "type": "string",
      "description": "The hair color of this person. Will be 'unknown' if not known or 'n/a' if the person does not have hair"
    },
    "skin_color": {
      "type": "string",
      "description": "The skin color of this person"
    },
    "eye_color": {
      "type": "string",
      "description": "The eye color of this person. Will be 'unknown' if not known or 'n/a' if the person does not have eyes"
    },
    "birth_year": {
      "type": "string",
      "description": "The birth year of the person, using the in-universe standard of BBY or ABY - Before the Battle of Yavin or After the Battle of Yavin"
    },
    "gender": {
      "type": "string",
      "description": "The gender of this person. Either 'male', 'female' or 'unknown', 'n/a' if the person does not have a gender"
    },
    "homeworld": {
      "type": "string",
      "format": "uri",
      "description": "URL of the planet resource that this person was born on"
    },
    "films": {
      "type": "array",
      "description": "URLs of film resources this person has been in",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "species": {
      "type": "array",
      "description": "URLs of species resources that this person belongs to",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "vehicles": {
      "type": "array",
      "description": "URLs of vehicle resources that this person has piloted",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "starships": {
      "type": "array",
      "description": "URLs of starship resources that this person has piloted",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "created": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 date-time when this resource was created"
    },
    "edited": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 date-time when this resource was last edited"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The hypermedia URL of this resource"
    }
  }
}