GET

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

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

{
    "id": 43,
    "url": "https://ll.thespacedevs.com/2.3.0/landings/43/?format=api",
    "attempt": false,
    "success": false,
    "description": "the first stage booster performed a controlled reentry, and an ocean touchdown test for the first time. This provided good test data, even though the booster started rolling as it neared the ocean, leading to the shutdown of the central engine as the roll depleted it of fuel, resulting in a hard impact with the ocean.",
    "downrange_distance": null,
    "landing_location": {
        "id": 18,
        "name": "Pacific Ocean",
        "active": true,
        "abbrev": "PAC",
        "description": "Pacific Ocean",
        "location": null,
        "longitude": null,
        "latitude": null,
        "image": {
            "id": 2242,
            "name": "Pacific Ocean from the ISS",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pacific_ocean_f_image_20240920094534.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pacific_ocean_f_image_thumbnail_20240920094534.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": []
        },
        "successful_landings": 46,
        "attempted_landings": 48,
        "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": 3,
        "name": "Ocean",
        "abbrev": "Ocean",
        "description": "No recovery attempt"
    },
    "response_mode": "detailed",
    "firststage": {
        "id": 6,
        "type": "Core",
        "reused": false,
        "launcher_flight_number": 1,
        "launcher": {
            "response_mode": "normal",
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/13/?format=api",
            "flight_proven": true,
            "serial_number": "B1003",
            "is_placeholder": false,
            "status": {
                "id": 4,
                "name": "lost"
            },
            "image": {
                "id": 1568,
                "name": "[AUTO] B1003 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/13_image_20191115082823.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193151.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "First flight of Falcon 9 v1.1 upgrade, first Spacex flight from Vandenberg",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2013-09-29T16:00:13Z",
            "first_launch_date": "2013-09-29T16:00:13Z",
            "fastest_turnaround": null
        },
        "previous_flight_date": null,
        "turn_around_time": null,
        "previous_flight": null
    },
    "spacecraftflight": null,
    "payloadflight": null
}