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 - lldev.thespacedevs.com/docs

GET /2.3.0/landings/1388/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 1388,
    "url": "https://lldev.thespacedevs.com/2.3.0/landings/1388/?format=api",
    "attempt": true,
    "success": true,
    "description": "The Superheavy booster No. 12 has successfully returned to the launch site at Starbase.",
    "downrange_distance": 0.0,
    "landing_location": {
        "id": 39,
        "name": "Orbital Launch Mount A",
        "active": true,
        "abbrev": "OLM-A",
        "description": "",
        "location": {
            "response_mode": "normal",
            "id": 143,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/143/?format=api",
            "name": "SpaceX Starbase, 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": "Starbase is an industrial complex for Starship rockets and the headquarters of the American aerospace manufacturer company SpaceX. Located near Brownsville, Texas, United States, it has been under construction since the late 2010s by SpaceX. Starbase is composed of a spaceport near the Gulf of Mexico, a production facility at the Boca Chica village, and a small structure test site along the Texas State Highway 4.",
            "image": {
                "id": 2219,
                "name": "SpaceX Starbase in March 2022",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_starbase_image_20240919170357.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_starbase_image_thumbnail_20240919170357.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": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg",
            "longitude": -97.157,
            "latitude": 25.997,
            "timezone_name": "America/Chicago",
            "total_launch_count": 17,
            "total_landing_count": 13
        },
        "longitude": -97.154423,
        "latitude": 25.9962,
        "image": {
            "id": 2241,
            "name": "OLM-A tower and catch arms",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/olm-a_tower_and_image_20240920094424.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/olm-a_tower_and_image_thumbnail_20240920094424.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": 3,
        "attempted_landings": 4,
        "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": 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": 546,
        "type": "Core",
        "reused": false,
        "launcher_flight_number": 1,
        "launcher": {
            "response_mode": "normal",
            "id": 150,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/150/?format=api",
            "flight_proven": true,
            "serial_number": "Booster 12",
            "is_placeholder": false,
            "status": {
                "id": 1,
                "name": "retired"
            },
            "image": {
                "id": 2255,
                "name": "Booster 12 during catch (IFT-5)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/booster_12_duri_image_20241013170813.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/booster_12_duri_image_thumbnail_20241013170814.jpeg",
                "credit": "SpaceX",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Super Heavy booster used for the fifth Starship integrated flight test.\r\n\r\nFirst Super Heavy sucessfully caught.",
            "successful_landings": 1,
            "attempted_landings": 1,
            "flights": 1,
            "last_launch_date": "2024-10-13T12:25:00Z",
            "first_launch_date": "2024-10-13T12:25:00Z",
            "fastest_turnaround": null
        },
        "previous_flight_date": null,
        "turn_around_time": null,
        "previous_flight": null
    },
    "spacecraftflight": null,
    "payloadflight": null
}