{"openapi":"3.1.0","info":{"title":"Star Wars API","version":"1.0.0","description":"The Star Wars universe as an API — every character, planet, film, starship, vehicle and species from the saga. Look up a record by id (e.g. people 1 → Luke Skywalker: 172 cm, born 19 BBY, homeworld Tatooine), search any category by name (e.g. people q=skywalker → Luke, Anakin and Shmi), or list whole categories with paging. Each record carries the full canonical data — physical traits and affiliations for characters; climate, terrain, gravity and population for planets; crew, hyperdrive rating, cargo and cost for starships and vehicles; titles, directors, opening crawls and release dates for the films — with cross-references between them. Backed by swapi.tech. Ideal for fan sites, quizzes and trivia games, Discord bots, learning projects and any Star Wars app.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/starwars-api","description":"oanor gateway"}],"tags":[{"name":"Star Wars"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/get":{"get":{"operationId":"get_v1_get","tags":["Star Wars"],"summary":"Full detail by category + id","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"Category, e.g. people","schema":{"type":"string"},"example":"people"},{"name":"id","in":"query","required":true,"description":"Record id, e.g. 1 (Luke Skywalker)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"people","result":{"uid":"1","url":"https://www.swapi.tech/api/people/1","mass":"77","name":"Luke Skywalker","films":["https://www.swapi.tech/api/films/1","https://www.swapi.tech/api/films/2","https://www.swapi.tech/api/films/3","https://www.swapi.tech/api/films/6"],"edited":"2026-05-31T05:22:39.375Z","gender":"male","height":"172","created":"2026-05-31T05:22:39.375Z","vehicles":["https://www.swapi.tech/api/vehicles/14","https://www.swapi.tech/api/vehicles/30"],"eye_color":"blue","homeworld":"https://www.swapi.tech/api/planets/1","starships":["https://www.swapi.tech/api/starships/12","https://www.swapi.tech/api/starships/22"],"birth_year":"19BBY","hair_color":"blond","skin_color":"fair","description":"A person within the Star Wars universe"}},"meta":{"timestamp":"2026-06-01T00:04:37.777Z","request_id":"e74e7699-5878-4261-87c0-3c763dded202"},"status":"ok","message":"Resource retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Star Wars"],"summary":"List a category (paginated; films whole)","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"people | planets | films | starships | vehicles | species","schema":{"type":"string"},"example":"people"},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"type":"people","count":10,"total":82,"results":[{"uid":"1","name":"Luke Skywalker"},{"uid":"2","name":"C-3PO"},{"uid":"3","name":"R2-D2"},{"uid":"4","name":"Darth Vader"},{"uid":"5","name":"Leia Organa"},{"uid":"6","name":"Owen Lars"},{"uid":"7","name":"Beru Whitesun lars"},{"uid":"8","name":"R5-D4"},{"uid":"9","name":"Biggs Darklighter"},{"uid":"10","name":"Obi-Wan Kenobi"}],"total_pages":9},"meta":{"timestamp":"2026-06-01T00:04:38.362Z","request_id":"af0393c7-32fc-4d0b-83bd-7d3d1c5bb808"},"status":"ok","message":"Resources listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Star Wars"],"summary":"Search a category by name","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"people | planets | starships | vehicles | species","schema":{"type":"string"},"example":"people"},{"name":"q","in":"query","required":true,"description":"Name to search, e.g. skywalker","schema":{"type":"string"},"example":"skywalker"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"people","count":3,"query":"skywalker","results":[{"uid":"1","url":"https://www.swapi.tech/api/people/1","mass":"77","name":"Luke Skywalker","films":["https://www.swapi.tech/api/films/1","https://www.swapi.tech/api/films/2","https://www.swapi.tech/api/films/3","https://www.swapi.tech/api/films/6"],"edited":"2026-05-31T05:22:39.375Z","gender":"male","height":"172","created":"2026-05-31T05:22:39.375Z","vehicles":["https://www.swapi.tech/api/vehicles/14","https://www.swapi.tech/api/vehicles/30"],"eye_color":"blue","homeworld":"https://www.swapi.tech/api/planets/1","starships":["https://www.swapi.tech/api/starships/12","https://www.swapi.tech/api/starships/22"],"birth_year":"19BBY","hair_color":"blond","skin_color":"fair","description":"A person within the Star Wars universe"},{"uid":"11","url":"https://www.swapi.tech/api/people/11","mass":"84","name":"Anakin Skywalker","films":["https://www.swapi.tech/api/films/4","https://www.swapi.tech/api/films/5","https://www.swapi.tech/api/films/6"],"edited":"2026-05-31T05:22:39.375Z","gender":"male","height":"188","created":"2026-05-31T05:22:39.375Z","vehicles":["https://www.swapi.tech/api/vehicles/44","https://www.swapi.tech/api/vehicles/46"],"eye_color":"blue","homeworld":"https://www.swapi.tech/api/planets/1","starships":["https://www.swapi.tech/api/starships/39","https://www.swapi.tech/api/starships/59","https://www.swapi.tech/api/starships/65"],"birth_year":"41.9BBY","hair_color":"blond","skin_color":"fair","description":"A person within the Star Wars universe"},{"uid":"43","url":"https://www.swapi.tech/api/people/43","mass":"unknown","name":"Shmi Skywalker","films":["https://www.swapi.tech/api/films/4","https://www.swapi.tech/api/films/5"],"edited":"2026-05-31T05:22:39.375Z","gender":"female","height":"163","created":"2026-05-31T05:22:39.375Z","vehicles":[],"eye_color":"brown","homeworld":"https://www.swapi.tech/api/planets/1","starships":[],"birth_year":"72BBY","hair_color":"black","skin_color":"fair","description":"A person within the Star Wars universe"}]},"meta":{"timestamp":"2026-06-01T00:04:38.587Z","request_id":"60698182-ee10-4495-9264-4fad2ba602c9"},"status":"ok","message":"Resources searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Categories & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Star Wars universe. /v1/list = a category (type=people|planets|films|starships|vehicles|species, paged; films returned whole); /v1/get = full detail by type + id (e.g. type=people&id=1 → Luke Skywalker); /v1/search = search a category by name (e.g. type=people&q=skywalker). Records carry the full SWAPI property set with cross-references.","types":["people","planets","films","starships","vehicles","species"],"source":"swapi.tech (Star Wars API)","endpoints":["/v1/list","/v1/get","/v1/search","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:38.666Z","request_id":"89268484-4bc0-443e-8533-cf2c1b805b3c"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":390,"monthly_call_quota":100000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1240,"monthly_call_quota":500000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3390,"monthly_call_quota":2400000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/starwars-api"}