Landing Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /landings/?mode=list
Filters
Parameters - attempt, firststage_launch__ids, landing_location__ids, landing_type__ids, launcher__ids, launcher_config__ids, launcher_serial_numbers, spacecraft__ids, spacecraft_config__ids, spacecraft_launch__ids, success
Example - /landings/?spacecraft__ids=39,37
Search
Fields searched - firststage__launcher__launcher_config__name, firststage__launcher__serial_number, firststage__rocket__launch__name, landing_location__abbrev, landing_location__name, spacecraftflight__rocket__launch__name, spacecraftflight__spacecraft__name, spacecraftflight__spacecraft__serial_number, spacecraftflight__spacecraft__spacecraft_config__name
Example - /landings/?search=B1059
Ordering
Fields - downrange_distance, id
Example - /landings/?ordering=downrange_distance
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /landings/?limit=2
Format
Switch to JSON output - /landings/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/landings/75/?format=api
{ "id": 75, "url": "https://ll.thespacedevs.com/2.3.0/landings/75/?format=api", "attempt": true, "success": true, "description": "The first stage of the Falcon 9 landed on the ASDS, OCISLY, stationed of the east coast.", "downrange_distance": null, "landing_location": { "id": 1, "name": "Of Course I Still Love You", "active": true, "abbrev": "OCISLY", "description": "The second ASDS barge, Of Course I Still Love You (OCISLY) services launches in the Pacific Ocean and was the site of the first landing of a SpaceX Falcon 9 first stage during CRS-8, the launch of a Dragon spacecraft to the International Space Station.", "location": null, "longitude": null, "latitude": null, "image": { "id": 1969, "name": "OCISLY empty", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ocisly_empty_image_20240310164323.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ocisly_empty_image_thumbnail_20240310164323.png", "credit": "SpaceX", "license": { "id": 5, "name": "CC BY-NC 2.0", "priority": 1, "link": "https://creativecommons.org/licenses/by-nc/2.0/" }, "single_use": true, "variants": [] }, "successful_landings": 128, "attempted_landings": 136, "failed_landings": 8, "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" } }, "type": { "id": 1, "name": "Autonomous Spaceport Drone Ship", "abbrev": "ASDS", "description": "An autonomous spaceport drone ship (ASDS) is an ocean-going vessel derived from a deck barge, outfitted with station-keeping engines and a large landing platform. Construction of such ships was commissioned by aerospace company SpaceX to allow for recovery of rocket first-stages at sea for high-velocity missions which do not carry enough fuel to return to the launch site after lofting spacecraft onto an orbital trajectory." }, "response_mode": "detailed", "firststage": { "id": 37, "type": "Core", "reused": true, "launcher_flight_number": 2, "launcher": { "response_mode": "normal", "id": 37, "url": "https://ll.thespacedevs.com/2.3.0/launchers/37/?format=api", "flight_proven": true, "serial_number": "B1029", "is_placeholder": false, "status": { "id": 1, "name": "retired" }, "image": { "id": 1592, "name": "[AUTO] B1029 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/37_image_20190226081059.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193230.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "details": "Retired.", "successful_landings": 2, "attempted_landings": 2, "flights": 2, "last_launch_date": "2017-06-23T19:10:00Z", "first_launch_date": "2017-01-14T17:54:34Z", "fastest_turnaround": "P160DT1H15M26S" }, "previous_flight_date": "2017-01-14T17:54:34Z", "turn_around_time": "P160DT1H15M26S", "previous_flight": { "id": "908879a4-f0da-4843-bd35-04eadd1dfb93", "url": "https://ll.thespacedevs.com/2.3.0/launches/908879a4-f0da-4843-bd35-04eadd1dfb93/?format=api", "name": "Falcon 9 Full Thrust | Iridium-1", "response_mode": "normal", "slug": "falcon-9-full-thrust-iridium-1", "launch_designator": "2017-003", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-12-29T19:06:35Z", "net": "2017-01-14T17:54:34Z", "net_precision": null, "window_end": "2017-01-14T17:54:34Z", "window_start": "2017-01-14T17:54:34Z", "image": { "id": 1734, "name": "[AUTO] Falcon 9 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon252092520full2520thrust_image_20190222031117.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193624.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": 60, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "list", "id": 121, "url": "https://ll.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } }, "rocket": { "id": 1980, "configuration": { "response_mode": "list", "id": 55, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/55/?format=api", "name": "Falcon 9", "families": [ { "response_mode": "list", "id": 1, "name": "Falcon" }, { "response_mode": "list", "id": 176, "name": "Falcon 9" } ], "full_name": "Falcon 9 Full Thrust", "variant": "Full Thrust" } }, "mission": { "id": 130, "name": "Iridium-1", "type": "Communications", "description": "SpaceX’s Falcon 9 rocket will deliver 10 satellites to low Earth orbit for Iridium, a global leader in mobile voice and data satellite communications. This is the first set of 10 satellites in a series of 75 total satellites that SpaceX will launch for Iridium’s next generation global satellite constellation, Iridium® NEXT.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 16, "url": "https://ll.thespacedevs.com/2.3.0/pads/16/?format=api", "active": true, "agencies": [], "name": "Space Launch Complex 4E", "image": { "id": 1342, "name": "Falcon 9 Block 5 | SARah 2 & 3 from SLC-4E", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20231223073520.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192449.jpeg", "credit": "SpaceX", "license": { "id": 5, "name": "CC BY-NC 2.0", "priority": 1, "link": "https://creativecommons.org/licenses/by-nc/2.0/" }, "single_use": false, "variants": [] }, "description": "Space Launch Complex 4 East (SLC-4E) is a launch site at Vandenberg Space Force Base, California, U.S.\r\n\r\nThe pad was previously used by Atlas and Titan rockets between 1963 and 2005. The pad was built for use by Atlas-Agena rockets, but was later rebuilt to handle Titan rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_4#SLC-4E", "map_url": "https://www.google.com/maps?q=34.632,-120.611", "latitude": 34.632, "longitude": -120.611, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_16_20200803143532.jpg", "total_launch_count": 190, "orbital_launch_attempt_count": 190, "fastest_turnaround": "P2DT22H21M10S", "location": { "response_mode": "normal", "id": 11, "url": "https://ll.thespacedevs.com/2.3.0/locations/11/?format=api", "name": "Vandenberg SFB, CA, 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": 7147, "successful_launches": 6604, "failed_launches": 543, "total_attempted_landings": 1101, "successful_landings": 1058, "failed_landings": 43 }, "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": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "image": { "id": 2226, "name": "Vandenberg SFB imaged by Sentinel-2", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_20240920082910.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_thumbnail_20240920082910.jpeg", "credit": "Contains modified Copernicus Sentinel data 2020", "license": { "id": 33, "name": "Copernicus Image Use Policy", "priority": 0, "link": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32013R1159" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "longitude": -120.52023, "latitude": 34.75133, "timezone_name": "America/Los_Angeles", "total_launch_count": 804, "total_landing_count": 26 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 28, "url": "https://ll.thespacedevs.com/2.3.0/programs/28/?format=api", "name": "Iridium Constellation", "image": { "id": 1870, "name": "[AUTO] Iridium Constellation - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iridium2520con_program_20231228184831.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194006.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://iridium.com/", "wiki_url": "https://en.wikipedia.org/wiki/Iridium_satellite_constellation", "description": "The Iridium satellite constellation provides L band voice and data information coverage to satellite phones, satellite messenger communication devices and integrated transceivers.", "agencies": [ { "response_mode": "list", "id": 202, "url": "https://ll.thespacedevs.com/2.3.0/agencies/202/?format=api", "name": "Iridium Communications", "abbrev": "IRDM", "type": { "id": 3, "name": "Commercial" } } ], "start_date": "1997-05-05T00:00:00Z", "end_date": null, "mission_patches": [], "type": { "id": 3, "name": "Communication Constellation" } } ], "orbital_launch_attempt_count": 5618, "location_launch_attempt_count": 666, "pad_launch_attempt_count": 71, "agency_launch_attempt_count": 35, "orbital_launch_attempt_count_year": 3, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1 } }, "spacecraftflight": null, "payloadflight": null }
