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/117/?format=api
{ "id": 117, "url": "https://ll.thespacedevs.com/2.3.0/landings/117/?format=api", "attempt": true, "success": true, "description": "The first stage successfully landed for the fourth time", "downrange_distance": 3.2, "landing_location": { "id": 11, "name": "Corn Ranch Landing Pad, West Texas", "active": true, "abbrev": "CR", "description": "New Shepard landing site.", "location": { "response_mode": "normal", "id": 29, "url": "https://ll.thespacedevs.com/2.3.0/locations/29/?format=api", "name": "Corn Ranch, Van Horn, TX, USA", "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": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.", "image": { "id": 2098, "name": "New Shepard liftoff (NS-25)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg", "credit": "Blue Origin", "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_29_20200803142436.jpg", "longitude": -104.757152, "latitude": 31.422927, "timezone_name": "America/Chicago", "total_launch_count": 31, "total_landing_count": 31 }, "longitude": -104.762793, "latitude": 31.451665, "image": { "id": 1972, "name": "NS landing pad with booster landing on it", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_20240310165834.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_thumbnail_20240310165835.jpeg", "credit": "Blue Origin", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "successful_landings": 26, "attempted_landings": 28, "failed_landings": 2, "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": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." }, "response_mode": "detailed", "firststage": { "id": 82, "type": "Core", "reused": true, "launcher_flight_number": 4, "launcher": { "response_mode": "normal", "id": 62, "url": "https://ll.thespacedevs.com/2.3.0/launchers/62/?format=api", "flight_proven": true, "serial_number": "NS-2", "is_placeholder": false, "status": { "id": 1, "name": "retired" }, "image": { "id": 1657, "name": "[AUTO] NS-2 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/62_image_20190225163937.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193417.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "details": "The New Shepard 2 or NS2, made five successful flights in 2015 and 2016, being retired after its fifth flight in October 2016. It was the first booster which Blue Origin successfully landed and reused.", "successful_landings": 5, "attempted_landings": 5, "flights": 5, "last_launch_date": "2016-10-05T16:36:00Z", "first_launch_date": "2015-11-23T17:21:00Z", "fastest_turnaround": "P59DT22H39M" }, "previous_flight_date": "2016-04-02T16:18:00Z", "turn_around_time": "P77DT22H57M", "previous_flight": { "id": "eb3e1460-55a3-4de0-bf3f-34eb302684d3", "url": "https://ll.thespacedevs.com/2.3.0/launches/eb3e1460-55a3-4de0-bf3f-34eb302684d3/?format=api", "name": "New Shepard | NS-4", "response_mode": "normal", "slug": "new-shepard-ns-4", "launch_designator": null, "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-06-14T09:48:15Z", "net": "2016-04-02T16:18:00Z", "net_precision": null, "window_end": "2016-04-02T16:18:00Z", "window_start": "2016-04-02T16:18:00Z", "image": { "id": 1795, "name": "[AUTO] New Shepard - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new2520shepard_image_20190207032624.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193803.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": "NS4", "launch_service_provider": { "response_mode": "list", "id": 141, "url": "https://ll.thespacedevs.com/2.3.0/agencies/141/?format=api", "name": "Blue Origin", "abbrev": "BO", "type": { "id": 3, "name": "Commercial" } }, "rocket": { "id": 2183, "configuration": { "response_mode": "list", "id": 137, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/137/?format=api", "name": "New Shepard", "families": [], "full_name": "New Shepard", "variant": "" } }, "mission": { "id": 946, "name": "NS-4", "type": "Test Flight", "description": "The fourth flight for Blue Origin. The capsule reached an apogee of 103.8 kilometers.", "image": null, "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 90, "url": "https://ll.thespacedevs.com/2.3.0/pads/90/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 141, "url": "https://ll.thespacedevs.com/2.3.0/agencies/141/?format=api", "name": "Blue Origin", "abbrev": "BO", "type": { "id": 3, "name": "Commercial" }, "featured": 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": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": 2000, "launchers": "New Shepard | New Glenn", "spacecraft": "", "parent": null, "image": { "id": 5, "name": "[AUTO] Blue Origin - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184551.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 116, "name": "[AUTO] Blue Origin - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184921.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 45, "name": "[AUTO] Blue Origin - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184738.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "West Texas Suborbital Launch Site/ Corn Ranch", "image": null, "description": null, "info_url": "http://www.blueorigin.com", "wiki_url": "https://en.wikipedia.org/wiki/Corn_Ranch", "map_url": "https://www.google.com/maps?q=31.422878000000000,-104.757121000000000", "latitude": 31.422878, "longitude": -104.757121, "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_90_20200803143233.jpg", "total_launch_count": 31, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P20DT23H49M11S", "location": { "response_mode": "normal", "id": 29, "url": "https://ll.thespacedevs.com/2.3.0/locations/29/?format=api", "name": "Corn Ranch, Van Horn, TX, 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": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.", "image": { "id": 2098, "name": "New Shepard liftoff (NS-25)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg", "credit": "Blue Origin", "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_29_20200803142436.jpg", "longitude": -104.757152, "latitude": 31.422927, "timezone_name": "America/Chicago", "total_launch_count": 31, "total_landing_count": 31 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 } }, "spacecraftflight": null, "payloadflight": null }
