Location Instance
Modes
Levels of detail in the response - normal, detailed
Example - /locations/?mode=detailed
Filters
Parameters - active, country_code, id, name, name__contains, total_landing_count, total_landing_count__gt, total_landing_count__gte, total_landing_count__lt, total_landing_count__lte, total_launch_count, total_launch_count__gt, total_launch_count__gte, total_launch_count__lt, total_launch_count__lte
Example - /locations/?country_code=NZL
Search
Fields searched - country__alpha_3_code, name
Example - /locations/?search=Cape Canaveral
Ordering
Fields - total_landing_count, total_launch_count
Example - /locations/?ordering=-total_launch_count
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /locations/?limit=2
Format
Switch to JSON output - /locations/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/locations/32/?format=api
{ "response_mode": "detailed", "id": 32, "url": "https://lldev.thespacedevs.com/2.3.0/locations/32/?format=api", "name": "Hokkaido Spaceport, Japan", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7129, "successful_launches": 6587, "failed_launches": 542, "total_attempted_landings": 1089, "successful_landings": 1046, "failed_landings": 43 }, "active": true, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "description": "Rocket launch pad of Interstellar Technologies, located next to the Taiki Aerospace Research Field.", "image": { "id": 1792, "name": "MOMO liftoff (Flight 1)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/momo_image_20190705174455.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193758.jpeg", "credit": "Kyodo News", "license": { "id": 22, "name": "Kyodo News Copyright", "priority": 6, "link": "https://english.kyodonews.net/copyright.html" }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_32_20200803142407.jpg", "longitude": 143.441389, "latitude": 42.5, "timezone_name": "Asia/Tokyo", "total_launch_count": 7, "total_landing_count": 0, "pads": [ { "id": 106, "url": "https://lldev.thespacedevs.com/2.3.0/pads/106/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 1002, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1002/?format=api", "name": "Interstellar Technologies", "abbrev": "ISTECH", "type": { "id": 3, "name": "Commercial" } } ], "name": "Launch Complex 0", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Taiki_Aerospace_Research_Field", "map_url": "https://www.google.com/maps?q=42.50000000,143.441389", "latitude": 42.5, "longitude": 143.441389, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_106_20200803143453.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P27DT23H15M" }, { "id": 211, "url": "https://lldev.thespacedevs.com/2.3.0/pads/211/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 1002, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1002/?format=api", "name": "Interstellar Technologies", "abbrev": "ISTECH", "type": { "id": 3, "name": "Commercial" } } ], "name": "Launch Complex 1", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Taiki_Aerospace_Research_Field", "map_url": "https://www.google.com/maps?q=42.50000000,143.441389", "latitude": 42.5, "longitude": 143.441389, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_complex_1_20230816074610.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null } ] }
