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

{
  "id": 1746,
  "url": "https://lldev.thespacedevs.com/2.3.0/landings/1746/?format=api",
  "attempt": true,
  "success": false,
  "description": "The Long March 12A first stage booster performed its entry burn with issues and the booster crashed within several kilometers of the landing pad.",
  "downrange_distance": 252.0,
  "landing_location": {
    "id": 61,
    "name": "Long March 12A Landing Site",
    "active": true,
    "abbrev": "CZ-12A LZ",
    "description": "Landing site for first stage boosters of CASC’s Long March 12A rocket at Minqin County, Gansu Province, China.",
    "location": {
      "response_mode": "normal",
      "id": 17,
      "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api",
      "name": "Jiuquan Satellite Launch Center, People's Republic of China",
      "active": true,
      "country": {
        "id": 6,
        "name": "China",
        "alpha_2_code": "CN",
        "alpha_3_code": "CHN",
        "nationality_name": "Chinese",
        "nationality_name_composed": "Sino"
      },
      "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
      "image": {
        "id": 1374,
        "name": "Long March 2F/G liftoff (Shenzhou 16)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg",
        "credit": "CMS",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": false,
        "variants": []
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
      "longitude": 100.291111,
      "latitude": 40.958056,
      "timezone_name": "Asia/Shanghai",
      "total_launch_count": 281,
      "total_landing_count": 2
    },
    "longitude": 101.9227,
    "latitude": 39.04405,
    "image": null,
    "successful_landings": 0,
    "attempted_landings": 1,
    "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-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": 9,
    "name": "Vertical Landing",
    "abbrev": "VL",
    "description": "Vertical landing using engines"
  },
  "response_mode": "detailed",
  "firststage": {
    "id": 851,
    "type": "Core",
    "reused": false,
    "launcher_flight_number": 1,
    "launcher": {
      "response_mode": "normal",
      "id": 246,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/246/?format=api",
      "flight_proven": false,
      "serial_number": "LM-12A F1",
      "is_placeholder": false,
      "status": {
        "id": 7,
        "name": "destroyed"
      },
      "image": {
        "id": 2633,
        "name": "Long March 12A Flight 1 Liftoff",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_12a__image_20251224005749.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_12a__image_thumbnail_20251224005750.jpeg",
        "credit": "CASC",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": false,
        "variants": []
      },
      "details": "First stage booster used on the 1st flight of CASC's Long March 12A rocket. Booster attempted to land downrange on its dedicated landing pad, but the entry-landing burn was abnormal and it impacted the ground several kilometers from the landing pad.",
      "successful_landings": 0,
      "attempted_landings": 1,
      "flights": 1,
      "last_launch_date": "2025-12-23T02:00:00Z",
      "first_launch_date": "2025-12-23T02:00:00Z",
      "fastest_turnaround": null
    },
    "previous_flight_date": null,
    "turn_around_time": null,
    "previous_flight": null
  },
  "spacecraftflight": null,
  "payloadflight": null
}