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

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

{
  "id": 1602,
  "url": "https://lldev.thespacedevs.com/2.3.0/landings/1602/?format=api",
  "attempt": true,
  "success": false,
  "description": "Super Heavy Booster 14-2 did not made a planned splashdown near the launch site after disintegrating at landing burn start-up.",
  "downrange_distance": null,
  "landing_location": {
    "id": 16,
    "name": "Gulf of Mexico",
    "active": true,
    "abbrev": "GOM",
    "description": "Gulf of Mexico",
    "location": null,
    "longitude": null,
    "latitude": null,
    "image": {
      "id": 2234,
      "name": "Gulf of Mexico imaged by Aqua",
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gulf_of_mexico__image_20240920091356.jpg",
      "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gulf_of_mexico__image_thumbnail_20240920091357.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": 18,
    "attempted_landings": 21,
    "failed_landings": 3,
    "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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.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": 721,
    "type": "Core",
    "reused": true,
    "launcher_flight_number": 2,
    "launcher": {
      "response_mode": "normal",
      "id": 189,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/189/?format=api",
      "flight_proven": true,
      "serial_number": "Booster 14",
      "is_placeholder": false,
      "status": {
        "id": 7,
        "name": "destroyed"
      },
      "image": {
        "id": 2333,
        "name": "Starship Booster 14 tower catch",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_booste_image_20250221071829.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_booste_image_thumbnail_20250221071829.jpeg",
        "credit": "SpaceX",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "Super Heavy booster used for the 7th Starship flight test. Successfully caught by the launch tower. Reused on the 9th Starship flight test for a planned high speed water splashdown but destroyed during landing burn.",
      "successful_landings": 1,
      "attempted_landings": 2,
      "flights": 2,
      "last_launch_date": "2025-05-27T23:36:00Z",
      "first_launch_date": "2025-01-16T22:37:00Z",
      "fastest_turnaround": "P131DT59M"
    },
    "previous_flight_date": "2025-01-16T22:37:00Z",
    "turn_around_time": "P131DT59M",
    "previous_flight": null
  },
  "spacecraftflight": null,
  "payloadflight": null
}