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

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/71/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 71,
    "url": "https://ll.thespacedevs.com/2.3.0/landings/71/?format=api",
    "attempt": true,
    "success": true,
    "description": "The first stage of the Falcon 9 landed on the ASDS, OCISLY, stationed of the east coast. This marked the first time an orbital class booster had been reused!",
    "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": 33,
        "type": "Core",
        "reused": true,
        "launcher_flight_number": 2,
        "launcher": {
            "response_mode": "normal",
            "id": 30,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/30/?format=api",
            "flight_proven": true,
            "serial_number": "B1021",
            "is_placeholder": false,
            "status": {
                "id": 1,
                "name": "retired"
            },
            "image": {
                "id": 1585,
                "name": "[AUTO] B1021 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/30_image_20190226080922.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193219.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Retired; on permanent display outside DISH Network Corporation headquarters in Littleton, Colorado.",
            "successful_landings": 2,
            "attempted_landings": 2,
            "flights": 2,
            "last_launch_date": "2017-03-30T22:27:00Z",
            "first_launch_date": "2016-04-08T20:43:32Z",
            "fastest_turnaround": "P356DT1H43M28S"
        },
        "previous_flight_date": "2016-04-08T20:43:32Z",
        "turn_around_time": "P356DT1H43M28S",
        "previous_flight": {
            "id": "d47b8475-1175-479e-99b4-c86d535558e1",
            "url": "https://ll.thespacedevs.com/2.3.0/launches/d47b8475-1175-479e-99b4-c86d535558e1/?format=api",
            "name": "Falcon 9 Full Thrust | SpX CRS-8",
            "response_mode": "normal",
            "slug": "falcon-9-full-thrust-spx-crs-8",
            "launch_designator": "2016-024",
            "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-14T17:41:46Z",
            "net": "2016-04-08T20:43:32Z",
            "net_precision": null,
            "window_end": "2016-04-08T20:43:32Z",
            "window_start": "2016-04-08T20:43:32Z",
            "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": 90,
            "weather_concerns": null,
            "failreason": null,
            "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": 1921,
                "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": 118,
                "name": "SpX CRS-8",
                "type": "Resupply",
                "description": "SpaceX launched the Dragon spacecraft on their eighth operational cargo delivery mission to the International Space Station. Among the cargo was the Bigelow Aerospace’s BEAM module, which was attached to the station and will stay so for 2 years. BEAM is an expandable habitat module that will undergo tests to determine its worthiness during the stay. The flight was conducted under the Commercial Resupply Services contract with NASA.",
                "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": 80,
                "url": "https://ll.thespacedevs.com/2.3.0/pads/80/?format=api",
                "active": true,
                "agencies": [
                    {
                        "response_mode": "normal",
                        "id": 121,
                        "url": "https://ll.thespacedevs.com/2.3.0/agencies/121/?format=api",
                        "name": "SpaceX",
                        "abbrev": "SpX",
                        "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": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
                        "administrator": "CEO: Elon Musk",
                        "founding_year": 2002,
                        "launchers": "Falcon | Starship",
                        "spacecraft": "Dragon",
                        "parent": null,
                        "image": {
                            "id": 29,
                            "name": "[AUTO] SpaceX - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184704.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "logo": {
                            "id": 186,
                            "name": "[AUTO] SpaceX - logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185138.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "social_logo": {
                            "id": 94,
                            "name": "[AUTO] SpaceX - social_logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184848.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    }
                ],
                "name": "Space Launch Complex 40",
                "image": {
                    "id": 2113,
                    "name": "F9 liftoff from SLC-40 (SES-24)",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/f9_liftoff_from_image_20240621050513.jpeg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/f9_liftoff_from_image_thumbnail_20240621050514.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": "",
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_40",
                "map_url": "https://www.google.com/maps?q=28.56194122,-80.57735736",
                "latitude": 28.56194122,
                "longitude": -80.57735736,
                "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_80_20200803143323.jpg",
                "total_launch_count": 303,
                "orbital_launch_attempt_count": 303,
                "fastest_turnaround": "P2DT8H59M40S",
                "location": {
                    "response_mode": "normal",
                    "id": 12,
                    "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api",
                    "name": "Cape Canaveral SFS, FL, 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": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
                    "image": {
                        "id": 2200,
                        "name": "Cape Canaveral & KSC seen from orbit (STS-43)",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": []
                    },
                    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
                    "longitude": -80.577778,
                    "latitude": 28.488889,
                    "timezone_name": "America/New_York",
                    "total_launch_count": 1019,
                    "total_landing_count": 64
                }
            },
            "webcast_live": false,
            "program": [
                {
                    "response_mode": "normal",
                    "id": 11,
                    "url": "https://ll.thespacedevs.com/2.3.0/programs/11/?format=api",
                    "name": "Commercial Resupply Services",
                    "image": {
                        "id": 1878,
                        "name": "[AUTO] Commercial Resupply Services - image",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/commercial2520_program_20201129212219.png",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194021.png",
                        "credit": null,
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "info_url": null,
                    "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services",
                    "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.",
                    "agencies": [
                        {
                            "response_mode": "list",
                            "id": 44,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api",
                            "name": "National Aeronautics and Space Administration",
                            "abbrev": "NASA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 257,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/257/?format=api",
                            "name": "Northrop Grumman Space Systems",
                            "abbrev": "NGSS",
                            "type": {
                                "id": 3,
                                "name": "Commercial"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 1020,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1020/?format=api",
                            "name": "Sierra Nevada Corporation",
                            "abbrev": "SNC",
                            "type": {
                                "id": 3,
                                "name": "Commercial"
                            }
                        },
                        {
                            "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"
                            }
                        }
                    ],
                    "start_date": "2008-12-23T00:00:00Z",
                    "end_date": null,
                    "mission_patches": [],
                    "type": {
                        "id": 2,
                        "name": "Human Spaceflight"
                    }
                },
                {
                    "response_mode": "normal",
                    "id": 17,
                    "url": "https://ll.thespacedevs.com/2.3.0/programs/17/?format=api",
                    "name": "International Space Station",
                    "image": {
                        "id": 1874,
                        "name": "[AUTO] International Space Station - image",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194014.png",
                        "credit": null,
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html",
                    "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme",
                    "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.",
                    "agencies": [
                        {
                            "response_mode": "list",
                            "id": 16,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/16/?format=api",
                            "name": "Canadian Space Agency",
                            "abbrev": "CSA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 27,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/27/?format=api",
                            "name": "European Space Agency",
                            "abbrev": "ESA",
                            "type": {
                                "id": 2,
                                "name": "Multinational"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 37,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/37/?format=api",
                            "name": "Japan Aerospace Exploration Agency",
                            "abbrev": "JAXA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 44,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api",
                            "name": "National Aeronautics and Space Administration",
                            "abbrev": "NASA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        },
                        {
                            "response_mode": "list",
                            "id": 63,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api",
                            "name": "Russian Federal Space Agency (ROSCOSMOS)",
                            "abbrev": "RFSA",
                            "type": {
                                "id": 1,
                                "name": "Government"
                            }
                        }
                    ],
                    "start_date": "1998-11-20T06:40:00Z",
                    "end_date": null,
                    "mission_patches": [],
                    "type": {
                        "id": 2,
                        "name": "Human Spaceflight"
                    }
                }
            ],
            "orbital_launch_attempt_count": 5553,
            "location_launch_attempt_count": 740,
            "pad_launch_attempt_count": 76,
            "agency_launch_attempt_count": 28,
            "orbital_launch_attempt_count_year": 24,
            "location_launch_attempt_count_year": 4,
            "pad_launch_attempt_count_year": 2,
            "agency_launch_attempt_count_year": 3
        }
    },
    "spacecraftflight": null,
    "payloadflight": null
}