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

{
    "id": 137,
    "url": "https://ll.thespacedevs.com/2.3.0/landings/137/?format=api",
    "attempt": true,
    "success": true,
    "description": "Sarge 1 successfully landed back on Earth.",
    "downrange_distance": null,
    "landing_location": {
        "id": 13,
        "name": "Spaceport America",
        "active": true,
        "abbrev": "SA",
        "description": "FAA-licensed spaceport  in New Mexico.",
        "location": {
            "response_mode": "normal",
            "id": 31,
            "url": "https://ll.thespacedevs.com/2.3.0/locations/31/?format=api",
            "name": "Spaceport America, NM, 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": "Spaceport America is an FAA-licensed spaceport located in the Jornada del Muerto desert basin north of Las Cruces, New Mexico, and southeast of Truth or Consequences. With Virgin Galactic's launch of the VSS Unity, with three people aboard, on May 22, 2021, New Mexico became the third US state to launch humans into space after California and Florida.",
            "image": {
                "id": 2217,
                "name": "Spaceport America",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_20240919165536.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_thumbnail_20240919165536.jpeg",
                "credit": "Land Rover MENA",
                "license": {
                    "id": 28,
                    "name": "CC BY 2.0",
                    "priority": 6,
                    "link": "https://creativecommons.org/licenses/by/2.0/"
                },
                "single_use": false,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_31_20200803142505.jpg",
            "longitude": -106.969722,
            "latitude": 32.990278,
            "timezone_name": "America/Denver",
            "total_launch_count": 4,
            "total_landing_count": 4
        },
        "longitude": -106.969722,
        "latitude": 32.990278,
        "image": {
            "id": 2217,
            "name": "Spaceport America",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_20240919165536.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceport_ameri_image_thumbnail_20240919165536.jpeg",
            "credit": "Land Rover MENA",
            "license": {
                "id": 28,
                "name": "CC BY 2.0",
                "priority": 6,
                "link": "https://creativecommons.org/licenses/by/2.0/"
            },
            "single_use": false,
            "variants": []
        },
        "successful_landings": 17,
        "attempted_landings": 18,
        "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": 4,
        "name": "Parachute Landing",
        "abbrev": "PCL",
        "description": "Unpowered landing using parachute(s)."
    },
    "response_mode": "detailed",
    "firststage": {
        "id": 107,
        "type": "Core",
        "reused": false,
        "launcher_flight_number": 1,
        "launcher": {
            "response_mode": "normal",
            "id": 67,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/67/?format=api",
            "flight_proven": true,
            "serial_number": "SARGE 1",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1660,
                "name": "[AUTO] SARGE 1 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/67_image_20190629182855.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193421.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Sarge 1 is the first SARGE reusable sounding rocket.",
            "successful_landings": 3,
            "attempted_landings": 4,
            "flights": 4,
            "last_launch_date": "2019-10-26T17:40:15Z",
            "first_launch_date": "2018-08-25T18:15:00Z",
            "fastest_turnaround": "P118DT23H39M57S"
        },
        "previous_flight_date": null,
        "turn_around_time": null,
        "previous_flight": null
    },
    "spacecraftflight": null,
    "payloadflight": null
}