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

{
    "id": 285,
    "url": "https://lldev.thespacedevs.com/2.3.0/landings/285/?format=api",
    "attempt": true,
    "success": null,
    "description": "The Falcon 9 first stage will attempt to land back at the launch site after this flight.",
    "downrange_distance": 14.9,
    "landing_location": {
        "id": 4,
        "name": "Landing Zone 1",
        "active": true,
        "abbrev": "LZ-1",
        "description": "LZ-1 Pad located at Cape Canaveral Space Force Station at the previous LC-13",
        "location": {
            "response_mode": "normal",
            "id": 12,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/12/?format=api",
            "name": "Cape Canaveral SFS, FL, 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": "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": 1014,
            "total_landing_count": 62
        },
        "longitude": -80.542963,
        "latitude": 28.485712,
        "image": {
            "id": 1968,
            "name": "LZ-1 empty",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/lz-1_empty_image_20240310163411.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/lz-1_empty_image_thumbnail_20240310163411.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": 50,
        "attempted_landings": 51,
        "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": 257,
        "type": "Core",
        "reused": null,
        "launcher_flight_number": null,
        "launcher": {
            "response_mode": "normal",
            "id": 106,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/106/?format=api",
            "flight_proven": false,
            "serial_number": "Unknown F9",
            "is_placeholder": true,
            "status": {
                "id": 8,
                "name": "N/A"
            },
            "image": {
                "id": 1674,
                "name": "[AUTO] Unknown F9 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/106_image_20230708172214.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193443.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster serial number unknown.",
            "successful_landings": null,
            "attempted_landings": null,
            "flights": null,
            "last_launch_date": null,
            "first_launch_date": null,
            "fastest_turnaround": null
        },
        "previous_flight_date": null,
        "turn_around_time": null,
        "previous_flight": null
    },
    "spacecraftflight": null,
    "payloadflight": null
}