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 - ll.thespacedevs.com/docs
GET /2.3.0/locations/3/?format=api
{ "response_mode": "detailed", "id": 3, "url": "https://ll.thespacedevs.com/2.3.0/locations/3/?format=api", "name": "Sea Launch", "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": 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": 1418, "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192712.jpeg", "credit": "CASC", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 40, "total_landing_count": 0, "pads": [ { "id": 148, "url": "https://ll.thespacedevs.com/2.3.0/pads/148/?format=api", "active": true, "agencies": [], "name": "Borisoglebsk (K-496)", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Borisoglebsk_(K-496)", "map_url": "https://www.google.com/maps?q=74.0000,38.0000", "latitude": 74.0, "longitude": 38.0, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_148_20200803143426.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 149, "url": "https://ll.thespacedevs.com/2.3.0/pads/149/?format=api", "active": true, "agencies": [], "name": "Ekaterinburg (K-84)", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Ekaterinburg_(K-84)", "map_url": "https://www.google.com/maps?q=74.000000,38.0000", "latitude": 74.0, "longitude": 38.0, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_149_20200803143409.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/pads/147/?format=api", "active": true, "agencies": [], "name": "Novomoskovsk (K-407)", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Novomoskovsk_(K-407)", "map_url": "https://www.google.com/maps?q=74.000000,38.000000", "latitude": 74.0, "longitude": 38.0, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_147_20200803143422.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 216, "url": "https://ll.thespacedevs.com/2.3.0/pads/216/?format=api", "active": true, "agencies": [], "name": "ADD Offshore launch platform", "image": { "id": 1338, "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png", "credit": "Yonhap", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "Offshore launch platform for the South Korean military small satellite launch vehicle.", "info_url": null, "wiki_url": null, "map_url": null, "latitude": 33.216667, "longitude": 126.366667, "country": { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_add_offshore_launch_platform_20231204142359.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 13, "url": "https://ll.thespacedevs.com/2.3.0/pads/13/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 80, "url": "https://ll.thespacedevs.com/2.3.0/agencies/80/?format=api", "name": "Boeing", "abbrev": "BA", "type": { "id": 3, "name": "Commercial" } } ], "name": "Launch Platform Odyssey", "image": null, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Odyssey_(launch_platform)", "map_url": "https://www.google.com/maps?q=0.0,-154", "latitude": 0.0, "longitude": -154.0, "country": null, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_13_20200803143257.jpg", "total_launch_count": 36, "orbital_launch_attempt_count": 36, "fastest_turnaround": "P50DT23H36M59S" }, { "id": 101, "url": "https://ll.thespacedevs.com/2.3.0/pads/101/?format=api", "active": true, "agencies": [], "name": "Unknown Pad", "image": null, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=0.0,0.0", "latitude": null, "longitude": null, "country": null, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_101_20200803143204.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null } ] }
