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 - ll.thespacedevs.com/docs
GET /2.3.0/locations/?format=api&offset=60&ordering=-total_landing_count
{ "count": 66, "next": null, "previous": "https://ll.thespacedevs.com/2.3.0/locations/?format=api&limit=10&offset=50&ordering=-total_landing_count", "results": [ { "response_mode": "normal", "id": 146, "url": "https://ll.thespacedevs.com/2.3.0/locations/146/?format=api", "name": "Svobodny Cosmodrome, 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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "failed_landings": 45 }, "active": false, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "description": "Svobodny was a Russian rocket launch site located approximately 15 km north of Svobodny, Amur Oblast. The cosmodrome was originally constructed as a launch site for intercontinental ballistic missiles called Svobodny-18. It was initially selected as a replacement for Baikonur Cosmodrome in the Kazakh Soviet Socialist Republic, which became independent as Kazakhstan after the dissolution of the Soviet Union. However the development of Svobodny was subsequently ended in 2007 in favour of a totally new space port, the Vostochny Cosmodrome.", "image": { "id": 2221, "name": "Start-1", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/start-1_image_20240919171507.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/start-1_image_thumbnail_20240919171507.jpeg", "credit": "TASS/Vladimir Sayapin", "license": { "id": 32, "name": "TASS Image Use Policy", "priority": 6, "link": "https://tass.com/terms-of-use" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_146_20200803142450.jpg", "longitude": 128.0, "latitude": 51.7, "timezone_name": "Asia/Yakutsk", "total_launch_count": 5, "total_landing_count": 0 }, { "response_mode": "normal", "id": 17, "url": "https://ll.thespacedevs.com/2.3.0/locations/17/?format=api", "name": "Jiuquan 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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "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": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "image": { "id": 1374, "name": "Long March 2F/G liftoff (Shenzhou 16)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg", "credit": "CMS", "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_17_20200803142429.jpg", "longitude": 100.291111, "latitude": 40.958056, "timezone_name": "Asia/Shanghai", "total_launch_count": 253, "total_landing_count": 0 }, { "response_mode": "normal", "id": 145, "url": "https://ll.thespacedevs.com/2.3.0/locations/145/?format=api", "name": "Shahrud Missile Test Site, Islamic Republic of Iran", "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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "failed_landings": 45 }, "active": true, "country": { "id": 32, "name": "Iran", "alpha_2_code": "IR", "alpha_3_code": "IRN", "nationality_name": "Iranian", "nationality_name_composed": "Irano" }, "description": "Shahroud Space Center is a Military Spaceport under control of the Islamic Revolutionary Guard Corps Aerospace Force (IRGCASF) located south-east of Shahroud Semnan Province, used to orbit military satellites for Iran's military space program.", "image": { "id": 2215, "name": "Qased on the pad (Noor)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/qased_on_the_pa_image_20240919164946.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/qased_on_the_pa_image_thumbnail_20240919164947.jpeg", "credit": "FARS", "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_145_20200803142443.jpg", "longitude": 55.3339, "latitude": 36.2009, "timezone_name": "Asia/Tehran", "total_launch_count": 6, "total_landing_count": 0 }, { "response_mode": "normal", "id": 24, "url": "https://ll.thespacedevs.com/2.3.0/locations/24/?format=api", "name": "Uchinoura Space Center, Japan", "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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "failed_landings": 45 }, "active": true, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "description": "The Uchinoura Space Center is a space launch facility in the Japanese town of Kimotsuki, Kagoshima Prefecture. All of Japan's scientific satellites were launched from Uchinoura prior to the M-V launch vehicles being decommissioned in 2006. It continues to be used for suborbital launches, stratospheric balloons and has also been used for the Epsilon orbital launch vehicle. Additionally, the center has antennas for communication with interplanetary space probes.", "image": { "id": 2225, "name": "Uchinoura Space Center, Japan", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_20240920082429.JPG", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_thumbnail_20240920082429.jpeg", "credit": "Ippukucho", "license": { "id": 19, "name": "CC BY 3.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/3.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_24_20200803142411.jpg", "longitude": 131.081944, "latitude": 31.251944, "timezone_name": "Asia/Tokyo", "total_launch_count": 43, "total_landing_count": 0 }, { "response_mode": "normal", "id": 6, "url": "https://ll.thespacedevs.com/2.3.0/locations/6/?format=api", "name": "Plesetsk Cosmodrome, 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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "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": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.", "image": { "id": 1461, "name": "Soyuz 2.1b/Fregat-M liftoff from pad 43/3 (Glonass-K2 No. 13, Kosmos 2569)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20230807181912.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192834.jpeg", "credit": "Mil.ru", "license": { "id": 30, "name": "CC BY 4.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/4.0/" }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "longitude": 40.577778, "latitude": 62.925556, "timezone_name": "Europe/Moscow", "total_launch_count": 1675, "total_landing_count": 0 }, { "response_mode": "normal", "id": 25, "url": "https://ll.thespacedevs.com/2.3.0/locations/25/?format=api", "name": "Pacific Spaceport Complex, Alaska, USA", "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": 7188, "successful_launches": 6643, "failed_launches": 545, "total_attempted_landings": 1129, "successful_landings": 1084, "failed_landings": 45 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "description": "The Pacific Spaceport Complex – Alaska (PSCA), formerly known as the Kodiak Launch Complex (KLC), is a dual-use commercial and military spaceport for sub-orbital and orbital launch vehicles. The facility is owned and operated by the Alaska Aerospace Corporation, a corporation owned by the Government of Alaska, and is located on Kodiak Island in Alaska.", "image": { "id": 1817, "name": "RS1 on the pad (Flight 2)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rs1_on_the_pad__image_20240325094914.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rs1_on_the_pad__image_thumbnail_20240325094914.jpeg", "credit": "ABL Space Systems", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_25_20200803142500.jpg", "longitude": -152.34, "latitude": 57.435278, "timezone_name": "America/Anchorage", "total_launch_count": 9, "total_landing_count": 0 } ] }
