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 - ll.thespacedevs.com/docs
GET /2.3.0/locations/16/?format=api
{ "response_mode": "detailed", "id": 16, "url": "https://ll.thespacedevs.com/2.3.0/locations/16/?format=api", "name": "Xichang Satellite Launch Center, People's Republic of China", "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": 7140, "successful_launches": 6598, "failed_launches": 542, "total_attempted_landings": 1098, "successful_landings": 1055, "failed_landings": 43 }, "active": true, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "description": "The Xichang Satellite Launch Center is a spaceport in China. It is located in Zeyuan Town, northwest of Xichang, Liangshan Yi Autonomous Prefecture in Sichuan.", "image": { "id": 1421, "name": "Long March 3B/E liftoff from LC-2 (Beidou-3 G4)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20230728061656.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192718.jpeg", "credit": "China Pictorial/Wanquan", "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_16_20200803142513.jpg", "longitude": 102.026556, "latitude": 28.246017, "timezone_name": "Asia/Shanghai", "total_launch_count": 224, "total_landing_count": 0, "pads": [ { "id": 86, "url": "https://ll.thespacedevs.com/2.3.0/pads/86/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 17, "url": "https://ll.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } } ], "name": "Unknown Pad", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.246017,102.026556", "latitude": 28.246017, "longitude": 102.026556, "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_86_20200803143555.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null }, { "id": 45, "url": "https://ll.thespacedevs.com/2.3.0/pads/45/?format=api", "active": true, "agencies": [], "name": "Launch Complex 2 (LC-2)", "image": { "id": 1421, "name": "Long March 3B/E liftoff from LC-2 (Beidou-3 G4)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20230728061656.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192718.jpeg", "credit": "China Pictorial/Wanquan", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.245564,102.026751", "latitude": 28.245564, "longitude": 102.026751, "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_45_20200803143520.jpg", "total_launch_count": 118, "orbital_launch_attempt_count": 118, "fastest_turnaround": "P16DT14H32M" }, { "id": 66, "url": "https://ll.thespacedevs.com/2.3.0/pads/66/?format=api", "active": true, "agencies": [ { "response_mode": "list", "id": 17, "url": "https://ll.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } } ], "name": "Launch Complex 3 (LC-3/LA-1)", "image": { "id": 2083, "name": "CZ-2D liftoff from LC-3 (Yaogan 42-02)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cz-2d_liftoff__image_20240428050501.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cz-2d_liftoff__image_thumbnail_20240428050502.jpeg", "credit": "央视新闻", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.247209,102.02917", "latitude": 28.247209, "longitude": 102.02917, "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_66_20200803143611.jpg", "total_launch_count": 99, "orbital_launch_attempt_count": 99, "fastest_turnaround": "P13DT6H21M" }, { "id": 157, "url": "https://ll.thespacedevs.com/2.3.0/pads/157/?format=api", "active": true, "agencies": [], "name": "Mobile Launcher Pad", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.242774,102.032944", "latitude": 28.242774, "longitude": 102.032944, "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_157_20200803143359.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7, "fastest_turnaround": "P74DT19H3M" } ] }
