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

{
    "id": 1584,
    "url": "https://lldev.thespacedevs.com/2.3.0/landings/1584/?format=api",
    "attempt": true,
    "success": true,
    "description": "The New Shepard booster NS-5 has landed back on the landing pad.",
    "downrange_distance": 3.2,
    "landing_location": {
        "id": 11,
        "name": "Corn Ranch Landing Pad, West Texas",
        "active": true,
        "abbrev": "CR",
        "description": "New Shepard landing site.",
        "location": {
            "response_mode": "normal",
            "id": 29,
            "url": "https://lldev.thespacedevs.com/2.3.0/locations/29/?format=api",
            "name": "Corn Ranch, Van Horn, 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": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.",
            "image": {
                "id": 2098,
                "name": "New Shepard liftoff (NS-25)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
            "longitude": -104.757152,
            "latitude": 31.422927,
            "timezone_name": "America/Chicago",
            "total_launch_count": 32,
            "total_landing_count": 32
        },
        "longitude": -104.762793,
        "latitude": 31.451665,
        "image": {
            "id": 1972,
            "name": "NS landing pad with booster landing on it",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_20240310165834.jpg",
            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_thumbnail_20240310165835.jpeg",
            "credit": "Blue Origin",
            "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
            },
            "single_use": true,
            "variants": []
        },
        "successful_landings": 27,
        "attempted_landings": 29,
        "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": 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": 708,
        "type": "Core",
        "reused": true,
        "launcher_flight_number": 3,
        "launcher": {
            "response_mode": "normal",
            "id": 187,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/187/?format=api",
            "flight_proven": true,
            "serial_number": "NS-5",
            "is_placeholder": false,
            "status": {
                "id": 3,
                "name": "active"
            },
            "image": {
                "id": 2317,
                "name": "NS-5 on the launch pad (NS-29)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns-5_on_the_lau_image_20250204174818.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ns-5_on_the_lau_image_thumbnail_20250204174819.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "5th New Shepard booster.",
            "successful_landings": 3,
            "attempted_landings": 3,
            "flights": 3,
            "last_launch_date": "2025-04-14T13:30:00Z",
            "first_launch_date": "2024-10-23T15:27:00Z",
            "fastest_turnaround": "P68DT21H30M"
        },
        "previous_flight_date": "2025-02-04T16:00:00Z",
        "turn_around_time": "P68DT21H30M",
        "previous_flight": {
            "id": "ccd1a7bc-8506-40c3-8967-9ce168084c2c",
            "url": "https://lldev.thespacedevs.com/2.3.0/launches/ccd1a7bc-8506-40c3-8967-9ce168084c2c/?format=api",
            "name": "New Shepard | NS-29",
            "response_mode": "normal",
            "slug": "new-shepard-ns-29",
            "launch_designator": null,
            "status": {
                "id": 3,
                "name": "Launch Successful",
                "abbrev": "Success",
                "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
            },
            "last_updated": "2025-02-04T17:16:06Z",
            "net": "2025-02-04T16:00:00Z",
            "net_precision": {
                "id": 0,
                "name": "Second",
                "abbrev": "SEC",
                "description": "The T-0 is accurate to the second."
            },
            "window_end": "2025-02-04T23:30:00Z",
            "window_start": "2025-02-04T15:30:00Z",
            "image": {
                "id": 2098,
                "name": "New Shepard liftoff (NS-25)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "infographic": null,
            "probability": null,
            "weather_concerns": null,
            "failreason": "",
            "hashtag": null,
            "launch_service_provider": {
                "response_mode": "list",
                "id": 141,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "rocket": {
                "id": 8472,
                "configuration": {
                    "response_mode": "list",
                    "id": 137,
                    "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/137/?format=api",
                    "name": "New Shepard",
                    "families": [],
                    "full_name": "New Shepard",
                    "variant": ""
                }
            },
            "mission": {
                "id": 7061,
                "name": "NS-29",
                "type": "Suborbital",
                "description": "NS-29 will simulate the Moon’s gravity and fly 30 payloads, all but one of which is focused on testing lunar-related technologies.\r\n\r\nThe payloads will experience at least two minutes of lunar gravity forces, a first for New Shepard and made possible in part through support from NASA. The flight will test six broad lunar technology areas: In-situ resource utilization, dust mitigation, advanced habitation systems, sensors and instrumentation, small spacecraft technologies, and entry descent and landing. Proving out these technologies at lower cost is another step toward Blue Origin’s mission to lower the cost of access to space for the benefit of Earth. It also enables NASA and other lunar surface technology providers to test innovations critical to achieving Artemis program goals and exploring the Moon’s surface. \r\n\r\nThe New Shepard crew capsule is using its Reaction Control System (RCS) to spin up to approximately 11 revolutions per minute. This spin rate simulates one-sixth Earth gravity at the midpoint of the crew capsule lockers. In simulated lunar gravity, customers can accelerate their learning and technology readiness for lunar payloads at much lower cost.",
                "image": null,
                "orbit": {
                    "id": 15,
                    "name": "Suborbital",
                    "abbrev": "Sub",
                    "celestial_body": {
                        "response_mode": "list",
                        "id": 1,
                        "name": "Earth"
                    }
                },
                "agencies": [
                    {
                        "response_mode": "normal",
                        "id": 141,
                        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                        "name": "Blue Origin",
                        "abbrev": "BO",
                        "type": {
                            "id": 3,
                            "name": "Commercial"
                        },
                        "featured": 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": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
                        "administrator": "CEO: Jeff Bezos",
                        "founding_year": 2000,
                        "launchers": "New Shepard | New Glenn",
                        "spacecraft": "",
                        "parent": null,
                        "image": {
                            "id": 5,
                            "name": "[AUTO] Blue Origin - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184551.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "logo": {
                            "id": 116,
                            "name": "[AUTO] Blue Origin - logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184921.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "social_logo": {
                            "id": 45,
                            "name": "[AUTO] Blue Origin - social_logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184738.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "total_launch_count": 33,
                        "consecutive_successful_launches": 10,
                        "successful_launches": 32,
                        "failed_launches": 1,
                        "pending_launches": 4,
                        "consecutive_successful_landings": 4,
                        "successful_landings": 30,
                        "failed_landings": 3,
                        "attempted_landings": 33,
                        "successful_landings_spacecraft": 32,
                        "failed_landings_spacecraft": 0,
                        "attempted_landings_spacecraft": 32,
                        "successful_landings_payload": 0,
                        "failed_landings_payload": 0,
                        "attempted_landings_payload": 0,
                        "info_url": "https://www.blueorigin.com/",
                        "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
                        "social_media_links": []
                    }
                ],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 90,
                "url": "https://lldev.thespacedevs.com/2.3.0/pads/90/?format=api",
                "active": true,
                "agencies": [
                    {
                        "response_mode": "normal",
                        "id": 141,
                        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                        "name": "Blue Origin",
                        "abbrev": "BO",
                        "type": {
                            "id": 3,
                            "name": "Commercial"
                        },
                        "featured": 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": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
                        "administrator": "CEO: Jeff Bezos",
                        "founding_year": 2000,
                        "launchers": "New Shepard | New Glenn",
                        "spacecraft": "",
                        "parent": null,
                        "image": {
                            "id": 5,
                            "name": "[AUTO] Blue Origin - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184551.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "logo": {
                            "id": 116,
                            "name": "[AUTO] Blue Origin - logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184921.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "social_logo": {
                            "id": 45,
                            "name": "[AUTO] Blue Origin - social_logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184738.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    }
                ],
                "name": "West Texas Suborbital Launch Site/ Corn Ranch",
                "image": null,
                "description": null,
                "info_url": "https://www.blueorigin.com",
                "wiki_url": "https://en.wikipedia.org/wiki/Corn_Ranch",
                "map_url": "https://www.google.com/maps?q=31.422878000000000,-104.757121000000000",
                "latitude": 31.422878,
                "longitude": -104.757121,
                "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_90_20200803143233.jpg",
                "total_launch_count": 32,
                "orbital_launch_attempt_count": 0,
                "fastest_turnaround": "P20DT23H49M11S",
                "location": {
                    "response_mode": "normal",
                    "id": 29,
                    "url": "https://lldev.thespacedevs.com/2.3.0/locations/29/?format=api",
                    "name": "Corn Ranch, Van Horn, TX, 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": 7177,
                        "successful_launches": 6632,
                        "failed_launches": 545,
                        "total_attempted_landings": 1122,
                        "successful_landings": 1077,
                        "failed_landings": 45
                    },
                    "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": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.",
                    "image": {
                        "id": 2098,
                        "name": "New Shepard liftoff (NS-25)",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg",
                        "credit": "Blue Origin",
                        "license": {
                            "id": 1,
                            "name": "Unknown",
                            "priority": 9,
                            "link": null
                        },
                        "single_use": true,
                        "variants": []
                    },
                    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
                    "longitude": -104.757152,
                    "latitude": 31.422927,
                    "timezone_name": "America/Chicago",
                    "total_launch_count": 32,
                    "total_landing_count": 32
                }
            },
            "webcast_live": false,
            "program": [],
            "orbital_launch_attempt_count": null,
            "location_launch_attempt_count": 29,
            "pad_launch_attempt_count": 29,
            "agency_launch_attempt_count": 30,
            "orbital_launch_attempt_count_year": 0,
            "location_launch_attempt_count_year": 1,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 2
        }
    },
    "spacecraftflight": null,
    "payloadflight": null
}