Location List
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/?format=api&offset=60&ordering=-total_landing_count
{ "count": 66, "next": null, "previous": "https://lldev.thespacedevs.com/2.3.0/locations/?format=api&limit=10&offset=50&ordering=-total_landing_count", "results": [ { "response_mode": "normal", "id": 168, "url": "https://lldev.thespacedevs.com/2.3.0/locations/168/?format=api", "name": "Oceanus Procellarum, Moon", "celestial_body": { "response_mode": "normal", "id": 2, "name": "Moon", "type": { "id": 2, "name": "Moon" }, "diameter": 3474800.0, "mass": 7.342e+22, "gravity": 1.622, "length_of_day": "27 07:43:12", "atmosphere": false, "image": { "id": 2041, "name": "Moon (Apollo 11)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/moon_2528apoll_image_20240402195408.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/moon_2528apoll_image_thumbnail_20240402195408.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": false, "variants": [] }, "description": "The Moon is Earth's only natural satellite.", "wiki_url": "https://en.wikipedia.org/wiki/Moon", "total_attempted_launches": 11, "successful_launches": 11, "failed_launches": 0, "total_attempted_landings": 16, "successful_landings": 14, "failed_landings": 2 }, "active": false, "country": null, "description": "Oceanus Procellarum is a vast lunar mare on the western edge of the near side of the Moon.", "image": { "id": 2141, "name": "Oceanus Procellarum", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mosaic_of_the_m_image_20240812093743.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mosaic_of_the_m_image_thumbnail_20240812093744.png", "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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_apollo_12_landing_site252c_oceanus_procellarum252c_moon_20240813032914.jpg", "longitude": -57.4, "latitude": 18.4, "timezone_name": "", "total_launch_count": 1, "total_landing_count": 0 }, { "response_mode": "normal", "id": 5, "url": "https://lldev.thespacedevs.com/2.3.0/locations/5/?format=api", "name": "Dombarovskiy, Russian Federation", "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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "active": true, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "description": "Dombarovsky is a military airbase near Yasny in Russia's Orenburg Oblast. Operated by the Soviet Air Defence Forces and later by the Russian Air Force, it hosted fighter interceptor squadrons and hosts an ICBM base (which has been adapted for commercial satellite launches) with a supporting helicopter base.", "image": { "id": 2201, "name": "Dnepr 1 liftoff (Prisma)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/dnepr_1_liftoff_image_20240918152530.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/dnepr_1_liftoff_image_thumbnail_20240918152530.jpeg", "credit": "ISC Kosmotras", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_5_20200803142425.jpg", "longitude": 59.853333, "latitude": 51.048889, "timezone_name": "Asia/Yekaterinburg", "total_launch_count": 10, "total_landing_count": 0 }, { "response_mode": "normal", "id": 142, "url": "https://lldev.thespacedevs.com/2.3.0/locations/142/?format=api", "name": "Ronald Reagan Ballistic Missile Defense Test Site, Kwajalein Atoll, Marshall Islands", "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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "active": true, "country": { "id": 52, "name": "Marshall Islands", "alpha_2_code": "MH", "alpha_3_code": "MHL", "nationality_name": "Marshallese", "nationality_name_composed": "Marshallese" }, "description": "The Ronald Reagan Ballistic Missile Defense Test Site is a missile test range in Marshall Islands. It covers about 750,000 square miles (1,900,000 km2) and includes rocket launch sites at the Kwajalein Atoll (on multiple islands), Wake Island, and Aur Atoll. It primarily functions as a test facility for U.S. missile defense and space research programs.", "image": { "id": 2211, "name": "Ronald Reagan Ballistic Missile Defense Test Site", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ronald_reagan_b_image_20240919163927.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ronald_reagan_b_image_thumbnail_20240919163927.jpeg", "credit": "US Army Space and Missile Defense Command", "license": { "id": 17, "name": "Department of Defense Image Use Policy", "priority": 6, "link": "https://www.dimoc.mil/resources/limitations/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_142_20200803142511.jpg", "longitude": 167.733333, "latitude": 8.716667, "timezone_name": "Pacific/Tarawa", "total_launch_count": 5, "total_landing_count": 0 }, { "response_mode": "normal", "id": 16, "url": "https://lldev.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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "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": 226, "total_landing_count": 0 }, { "response_mode": "normal", "id": 15, "url": "https://lldev.thespacedevs.com/2.3.0/locations/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "active": true, "country": { "id": 44, "name": "Kazakhstan", "alpha_2_code": "KZ", "alpha_3_code": "KAZ", "nationality_name": "Kazakh", "nationality_name_composed": "Kazakhstani" }, "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "image": { "id": 2198, "name": "Soyuz launch pad at the Baikonur Cosmodrome", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_20240918150530.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_thumbnail_20240918150530.jpeg", "credit": "NASA/Bill Ingalls", "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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "longitude": 63.305, "latitude": 45.965, "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1555, "total_landing_count": 0 }, { "response_mode": "normal", "id": 30, "url": "https://lldev.thespacedevs.com/2.3.0/locations/30/?format=api", "name": "Kapustin Yar, Russian Federation", "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": 7177, "successful_launches": 6632, "failed_launches": 545, "total_attempted_landings": 1122, "successful_landings": 1077, "failed_landings": 45 }, "active": true, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "description": "Kapustin Yar is a Russian military training area and a rocket launch complex in Astrakhan Oblast, about 100 km east of Volgograd. It was established by the Soviet Union on 13 May 1946. In the beginning, Kapustin Yar used technology, material, and scientific support gained from the defeat of Germany in World War II. Numerous launches of test rockets for the Russian military were carried out at the site, as well as satellite and sounding rocket launches.", "image": { "id": 2204, "name": "R-2A and R-5A geophysical rockets on the pad", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/r-2a_and_r-5a_g_image_20240918155857.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/r-2a_and_r-5a_g_image_thumbnail_20240918155857.jpeg", "credit": "Mil.ru", "license": { "id": 30, "name": "CC BY 4.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/4.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_30_20200803142515.jpg", "longitude": 45.72, "latitude": 48.59, "timezone_name": "Europe/Volgograd", "total_launch_count": 101, "total_landing_count": 0 } ] }
