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

{
    "id": 209,
    "url": "https://ll.thespacedevs.com/2.3.0/landings/209/?format=api",
    "attempt": true,
    "success": true,
    "description": "B1063 has successfully landed on ASDS JRTI after its second launch.",
    "downrange_distance": 631.0,
    "landing_location": {
        "id": 3,
        "name": "Just Read the Instructions",
        "active": true,
        "abbrev": "JRTI",
        "description": "Third (Marmac 303) ASDS barge, Just Read the Instructions (JRTI) is currently used to recover Falcon 9 and Heavy boosters in the Altantic Ocean.",
        "location": null,
        "longitude": null,
        "latitude": null,
        "image": {
            "id": 1973,
            "name": "JRTI (Marmac 303) empty",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jrti_2528marma_image_20240310170452.jpeg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jrti_2528marma_image_thumbnail_20240310170452.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": true,
            "variants": []
        },
        "successful_landings": 116,
        "attempted_landings": 117,
        "failed_landings": 1,
        "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": 178,
        "type": "Core",
        "reused": true,
        "launcher_flight_number": 2,
        "launcher": {
            "response_mode": "normal",
            "id": 84,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/84/?format=api",
            "flight_proven": true,
            "serial_number": "B1063",
            "is_placeholder": false,
            "status": {
                "id": 3,
                "name": "active"
            },
            "image": {
                "id": 1626,
                "name": "[AUTO] B1063 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/84_image_20201122121517.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193327.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Notable launches include Sentinel-6 and Dart.",
            "successful_landings": 25,
            "attempted_landings": 25,
            "flights": 25,
            "last_launch_date": "2025-04-28T20:42:30Z",
            "first_launch_date": "2020-11-21T17:17:08Z",
            "fastest_turnaround": "P32DT22H30M50S"
        },
        "previous_flight_date": "2020-11-21T17:17:08Z",
        "turn_around_time": "P186DT1H41M52S",
        "previous_flight": {
            "id": "56623c2d-7174-489c-b0ed-bf6f039b2412",
            "url": "https://ll.thespacedevs.com/2.3.0/launches/56623c2d-7174-489c-b0ed-bf6f039b2412/?format=api",
            "name": "Falcon 9 Block 5 | Sentinel-6 Michael Freilich",
            "response_mode": "normal",
            "slug": "falcon-9-block-5-sentinel-6-michael-freilich",
            "launch_designator": "2020-086",
            "status": {
                "id": 3,
                "name": "Launch Successful",
                "abbrev": "Success",
                "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
            },
            "last_updated": "2024-06-15T14:12:12Z",
            "net": "2020-11-21T17:17:08Z",
            "net_precision": {
                "id": 0,
                "name": "Second",
                "abbrev": "SEC",
                "description": "The T-0 is accurate to the second."
            },
            "window_end": "2020-11-21T17:17:08Z",
            "window_start": "2020-11-21T17:17:08Z",
            "image": {
                "id": 1381,
                "name": "[AUTO] Falcon 9 Block 5 | Sentinel-6 Michael Freilich - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20201121073649.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192602.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/falcon2520925_infographic_20201120193858.png",
            "probability": 80,
            "weather_concerns": null,
            "failreason": "",
            "hashtag": "#SeeingTheSeas",
            "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": 164,
                "configuration": {
                    "response_mode": "list",
                    "id": 164,
                    "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/164/?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 Block 5",
                    "variant": "Block 5"
                }
            },
            "mission": {
                "id": 910,
                "name": "Sentinel-6 Michael Freilich (Sentinel-6A; Jason-CS)",
                "type": "Earth Science",
                "description": "The Sentinel-6 Michael Freilich and Sentinel-6B make up the Sentinel-6 mission, also known as Jason Continuity of Service (Jason-CS), which is a partnership between NASA, NOAA, ESA, and EUMETSAT. This mission  continues the long-term global sea surface height data record begun by first Jason satellites in 1992. \r\n\r\nNamed after former NASA Earth Science Division Director Michael Freilich, Sentinel-6 Michail Freilich will provide altimeter data necessary for ocean climate monitoring, ocean modelling and numerical ocean prediction, weather forecasting, marine meteorology, coastal altimetry and modelling. A secondary objective of the mission is to collect high-resolution vertical profiles of temperature, using the Global Navigation Satellite System (GNSS) Radio-Occultation sounding technique, to assess temperature changes in the troposphere and stratosphere and to support numerical weather prediction.\r\n\r\nSentinel-6 Michael Freilich is to operate in a highly-inclined circular orbit at an altitude of 1336 km, with an operational mission lasting 5 years. Near-identical Sentinel-6B is planned to follow-up shortly after.",
                "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": 22,
                    "url": "https://ll.thespacedevs.com/2.3.0/programs/22/?format=api",
                    "name": "Copernicus",
                    "image": {
                        "id": 1879,
                        "name": "[AUTO] Copernicus - image",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/copernicus_program_20221129162831.png",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194023.png",
                        "credit": null,
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "info_url": "https://www.copernicus.eu",
                    "wiki_url": "https://en.wikipedia.org/wiki/Copernicus_Programme",
                    "description": "Copernicus is the European Union's Earth observation programme coordinated and managed for the European Commission by the European Union Agency for the Space Programme in partnership with the European Space Agency (ESA), the EU Member States. It aims at achieving a global, continuous, autonomous, high quality, wide range Earth observation capacity. Providing accurate, timely and easily accessible information to, among other things, improve the management of the environment, understand and mitigate the effects of climate change, and ensure civil security.",
                    "agencies": [
                        {
                            "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": 1043,
                            "url": "https://ll.thespacedevs.com/2.3.0/agencies/1043/?format=api",
                            "name": "European Union Agency for the Space Programme",
                            "abbrev": "EUSPA",
                            "type": {
                                "id": 2,
                                "name": "Multinational"
                            }
                        }
                    ],
                    "start_date": "2014-04-03T00:00:00Z",
                    "end_date": null,
                    "mission_patches": [],
                    "type": {
                        "id": 8,
                        "name": "Earth Observation"
                    }
                }
            ],
            "orbital_launch_attempt_count": 6017,
            "location_launch_attempt_count": 687,
            "pad_launch_attempt_count": 84,
            "agency_launch_attempt_count": 112,
            "orbital_launch_attempt_count_year": 95,
            "location_launch_attempt_count_year": 1,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 24
        }
    },
    "spacecraftflight": null,
    "payloadflight": null
}