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 - name, 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/20/?format=api
{ "response_mode": "detailed", "id": 20, "url": "https://lldev.thespacedevs.com/2.3.0/locations/20/?format=api", "name": "Air launch to orbit", "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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.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": 7651, "successful_launches": 7094, "failed_launches": 557, "total_attempted_landings": 1384, "successful_landings": 1335, "failed_landings": 49 }, "active": true, "country": { "id": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 33, "name": "Virgin Orbit LauncherOne", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/virgin2520orbit_image_20200101110056.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184714.jpeg", "credit": "Virgin Orbit", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_20_20200803142433.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 52, "total_landing_count": 0, "pads": [ { "id": 53, "url": "https://lldev.thespacedevs.com/2.3.0/pads/53/?format=api", "active": true, "agencies": [], "name": "Mojave Air and Space Port", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Mojave_Air_and_Space_Port", "map_url": "https://www.google.com/maps?q=35.059444,-118.151667", "latitude": 35.059444, "longitude": -118.151667, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_53_20200803143612.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P163DT19H8M9S" }, { "id": 62, "url": "https://lldev.thespacedevs.com/2.3.0/pads/62/?format=api", "active": true, "agencies": [], "name": "Vandenberg Space Force Base", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Force_Base", "map_url": "https://www.google.com/maps?q=34.732778,-120.568056", "latitude": 34.732778, "longitude": -120.568056, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_62_20200803143441.jpg", "total_launch_count": 22, "orbital_launch_attempt_count": 22, "fastest_turnaround": "P6DT6H6M15S" }, { "id": 59, "url": "https://lldev.thespacedevs.com/2.3.0/pads/59/?format=api", "active": true, "agencies": [], "name": "Kwajalein Atoll", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kwajalein_Atoll", "map_url": "https://www.google.com/maps?q=8.716667,167.733333", "latitude": 8.716667, "longitude": 167.733333, "country": { "id": 52, "name": "Marshall Islands", "alpha_2_code": "MH", "alpha_3_code": "MHL", "nationality_name": "Marshallese", "nationality_name_composed": "Marshallese" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_59_20200803143427.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P186DT44M35S" }, { "id": 84, "url": "https://lldev.thespacedevs.com/2.3.0/pads/84/?format=api", "active": true, "agencies": [], "name": "Cape Canaveral", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral", "map_url": "https://www.google.com/maps?q=28.455556,-80.527778", "latitude": 28.455556, "longitude": -80.527778, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_84_20200803143436.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7, "fastest_turnaround": "P92DT15H46M22S" }, { "id": 110, "url": "https://lldev.thespacedevs.com/2.3.0/pads/110/?format=api", "active": true, "agencies": [], "name": "Andersen Air Force Base", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Andersen_Air_Force_Base", "map_url": "https://www.google.com/maps?q=13.581111,144.924444", "latitude": 13.581111, "longitude": 144.924444, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_110_20200803143558.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null }, { "id": 189, "url": "https://lldev.thespacedevs.com/2.3.0/pads/189/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 199, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/199/?format=api", "name": "Virgin Orbit", "abbrev": "VO", "type": { "id": 3, "name": "Commercial" } } ], "name": "Spaceport Cornwall", "image": null, "description": null, "info_url": "https://spaceportcornwall.com/", "wiki_url": "https://en.wikipedia.org/wiki/Newquay_Airport", "map_url": "https://www.google.com/maps?q=50.4408333,-4.9974718", "latitude": 50.4408333, "longitude": -4.9974718, "country": { "id": 10, "name": "United Kingdom", "alpha_2_code": "GB", "alpha_3_code": "GBR", "nationality_name": "British", "nationality_name_composed": "Brito" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_spaceport_cornwall_20210514102058.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 52, "url": "https://lldev.thespacedevs.com/2.3.0/pads/52/?format=api", "active": true, "agencies": [], "name": "Wallops Flight Facility", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wallops_Flight_Facility", "map_url": "https://www.google.com/maps?q=37.938611,-75.457222", "latitude": 37.938611, "longitude": -75.457222, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_52_20200803143305.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 6, "fastest_turnaround": "P51DT12H42M" }, { "id": 70, "url": "https://lldev.thespacedevs.com/2.3.0/pads/70/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 100, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/100/?format=api", "name": "Orbital Sciences Corporation", "abbrev": "OSC", "type": { "id": 3, "name": "Commercial" } } ], "name": "Edwards Air Force Base", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Edwards_Air_Force_Base", "map_url": "https://www.google.com/maps?q=34.905556,-117.883611", "latitude": 34.905556, "longitude": -117.883611, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_70_20200803143352.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P75DT21H35M" }, { "id": 46, "url": "https://lldev.thespacedevs.com/2.3.0/pads/46/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 100, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/100/?format=api", "name": "Orbital Sciences Corporation", "abbrev": "OSC", "type": { "id": 3, "name": "Commercial" } } ], "name": "Gran Canaria", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Gran_Canaria", "map_url": "https://www.google.com/maps?q=27.966667,-15.6", "latitude": 27.966667, "longitude": -15.6, "country": { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_46_20200803143312.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 109, "url": "https://lldev.thespacedevs.com/2.3.0/pads/109/?format=api", "active": true, "agencies": [], "name": "Cecil Air and Space Port", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cecil_Airport", "map_url": "https://www.google.com/maps?q=30.224166,-81.876236", "latitude": 30.224166, "longitude": -81.876236, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_109_20200803143535.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null }, { "id": 104, "url": "https://lldev.thespacedevs.com/2.3.0/pads/104/?format=api", "active": true, "agencies": [], "name": "Guam International Airport", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Antonio_B._Won_Pat_International_Airport", "map_url": "https://www.google.com/maps?q=13.483889,144.797222", "latitude": 13.483889, "longitude": 144.797222, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_104_20200803143546.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null } ] }
