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/3/?format=api
{ "response_mode": "detailed", "id": 3, "url": "https://lldev.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": 7129, "successful_launches": 6587, "failed_launches": 542, "total_attempted_landings": 1089, "successful_landings": 1046, "failed_landings": 43 }, "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": 55, "total_landing_count": 0, "pads": [ { "id": 149, "url": "https://lldev.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": 186, "url": "https://lldev.thespacedevs.com/2.3.0/pads/186/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "name": "Tai Rui mobile launch platform", "image": null, "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=34.899444,121.190278", "latitude": 34.899444, "longitude": 121.190278, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_long_march_11_launch_platform_20200901183938.jpg", "total_launch_count": 3, "orbital_launch_attempt_count": 3, "fastest_turnaround": "P223DT3H5M" }, { "id": 212, "url": "https://lldev.thespacedevs.com/2.3.0/pads/212/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "name": "Haiyang Spaceport", "image": { "id": 1355, "name": "Gravity-1 liftoff from Haiyang Spaceport (Maiden flight)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192513.jpeg", "credit": "OrienSpace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "description": "Sea-based spaceport", "info_url": null, "wiki_url": null, "map_url": null, "latitude": 36.676794, "longitude": 121.235103, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_haiyang_spaceport_20230827174240.jpg", "total_launch_count": 4, "orbital_launch_attempt_count": 4, "fastest_turnaround": "P25DT21H9M" }, { "id": 217, "url": "https://lldev.thespacedevs.com/2.3.0/pads/217/?format=api", "active": true, "agencies": [], "name": "Bo Run Jiu Zhou mobile launch platform", "image": { "id": 1407, "name": "Smart Dragon 3 liftoff from Bo Run Jiu Zhou (9 satellites)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/smart2520drago_image_20240204094625.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192650.jpeg", "credit": "China Daily/Chen Xiaolong", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=21.283333,112.0", "latitude": 21.283333, "longitude": 112.0, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_bo_run_jiu_zhou_mobile_launch_platform_20231206001303.jpg", "total_launch_count": 3, "orbital_launch_attempt_count": 3, "fastest_turnaround": "P20DT3H15M" }, { "id": 101, "url": "https://lldev.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 }, { "id": 147, "url": "https://lldev.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": 148, "url": "https://lldev.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": 221, "url": "https://lldev.thespacedevs.com/2.3.0/pads/221/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "name": "Oriental Spaceport mobile launch ship", "image": null, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=35.391667%2C119.598667", "latitude": 35.391667, "longitude": 119.598667, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_oriental_spaceport_mobile_launch_ship_20240529085416.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2, "fastest_turnaround": "P204DT2H5M33S" }, { "id": 13, "url": "https://lldev.thespacedevs.com/2.3.0/pads/13/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 80, "url": "https://lldev.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": 89, "url": "https://lldev.thespacedevs.com/2.3.0/pads/89/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "name": "DeFu-15002 mobile launch platform", "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": [] }, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=36.631333,121.198361", "latitude": 36.631333, "longitude": 121.198361, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_89_20200803143242.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2, "fastest_turnaround": "P332DT20H24M17S" }, { "id": 144, "url": "https://lldev.thespacedevs.com/2.3.0/pads/144/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "name": "DeBo 3 mobile launch platform", "image": null, "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=34.311667,123.761111", "latitude": 34.311667, "longitude": 123.761111, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_144_20200803143251.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null }, { "id": 216, "url": "https://lldev.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 } ] }
