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

{
  "id": 1810,
  "url": "https://lldev.thespacedevs.com/2.3.0/landings/1810/?format=api",
  "attempt": false,
  "success": null,
  "description": "The reusable space plane will land on the Lop Nur dried salt lake.",
  "downrange_distance": null,
  "landing_location": {
    "id": 30,
    "name": "Lop Nur Airbase",
    "active": true,
    "abbrev": "LNA",
    "description": "Military airbase located on a dried salt lake in the Xinjiang Uygur Autonomous Region, China.",
    "location": null,
    "longitude": 89.28202039,
    "latitude": 40.77287097,
    "image": {
      "id": 2237,
      "name": "Lop Nur Airbase",
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/lop_nur_airbase_image_20240920092126.jpg",
      "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/lop_nur_airbase_image_thumbnail_20240920092126.jpeg",
      "credit": "Planet Labs",
      "license": {
        "id": 1,
        "name": "Unknown",
        "priority": 9,
        "link": null
      },
      "single_use": true,
      "variants": []
    },
    "successful_landings": 3,
    "attempted_landings": 3,
    "failed_landings": 0,
    "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": 6,
    "name": "Horizontal Landing",
    "abbrev": "HL",
    "description": "Horizontal landing on a runway or flat surface."
  },
  "response_mode": "detailed",
  "firststage": null,
  "spacecraftflight": {
    "id": 903,
    "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_flights/903/?format=api",
    "destination": "Low Earth Orbit",
    "mission_end": null,
    "spacecraft": {
      "response_mode": "normal",
      "id": 560,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/560/?format=api",
      "name": "Chinese Reusable Space Vehicle",
      "serial_number": null,
      "is_placeholder": false,
      "image": null,
      "in_space": true,
      "time_in_space": "P811DT11H24M38S",
      "time_docked": "P0D",
      "flights_count": 4,
      "mission_ends_count": 3,
      "status": {
        "id": 1,
        "name": "Active"
      },
      "description": "First Chinese reusable spacecraft, apparently a spaceplane with wings per a photo taken by a US satellite. No public information of it is available.\r\n\r\nIts official name is \"Chongfu Shiyong Shiyan Hangtian Qi\", meaning \"Reusable Experimental Spacecraft\".\r\n\r\nNote: It is unknown how many flight vehicles have been built and flown.",
      "spacecraft_config": {
        "response_mode": "detailed",
        "id": 31,
        "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/31/?format=api",
        "name": "Chinese Reusable Space Vehicle",
        "type": {
          "id": 3,
          "name": "Spaceplane"
        },
        "agency": {
          "response_mode": "normal",
          "id": 88,
          "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
          "name": "China Aerospace Science and Technology Corporation",
          "abbrev": "CASC",
          "type": {
            "id": 1,
            "name": "Government"
          },
          "featured": true,
          "country": [
            {
              "id": 6,
              "name": "China",
              "alpha_2_code": "CN",
              "alpha_3_code": "CHN",
              "nationality_name": "Chinese",
              "nationality_name_composed": "Sino"
            }
          ],
          "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
          "administrator": "Chairman & President: Lei Fanpei",
          "founding_year": 1999,
          "launchers": "Long March",
          "spacecraft": "",
          "parent": null,
          "image": {
            "id": 8,
            "name": "[AUTO] China Aerospace Science and Technology Corporation - image",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg",
            "credit": null,
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": true,
            "variants": []
          },
          "logo": {
            "id": 124,
            "name": "[AUTO] China Aerospace Science and Technology Corporation - logo",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png",
            "credit": null,
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": true,
            "variants": []
          },
          "social_logo": {
            "id": 50,
            "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png",
            "credit": null,
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": true,
            "variants": []
          }
        },
        "family": [],
        "in_use": true,
        "image": null,
        "capability": "Reusable technology demonstration test bed for orbital and re-entry operations.",
        "history": "First launched on September 4, 2020 and landed two days later. Launched again on August 4, 2022.",
        "details": "The Chinese reusable experimental spacecraft is the first Chinese reusable spacecraft.",
        "maiden_flight": "2020-09-04",
        "height": null,
        "diameter": null,
        "human_rated": false,
        "crew_capacity": null,
        "payload_capacity": null,
        "payload_return_capacity": null,
        "flight_life": "Multiple months",
        "wiki_link": "https://en.wikipedia.org/wiki/Chinese_reusable_experimental_spacecraft",
        "info_link": "",
        "spacecraft_flown": 1,
        "total_launch_count": 4,
        "successful_launches": 4,
        "failed_launches": 0,
        "attempted_landings": 3,
        "successful_landings": 3,
        "failed_landings": 0,
        "fastest_turnaround": "P220DT13H52M"
      },
      "fastest_turnaround": "P220DT13H52M"
    },
    "launch": {
      "id": "a9fd7757-9a51-4607-845d-d830673c4486",
      "url": "https://lldev.thespacedevs.com/2.3.0/launches/a9fd7757-9a51-4607-845d-d830673c4486/?format=api",
      "name": "Long March 2F/G | Chinese Reusable Space Vehicle",
      "response_mode": "normal",
      "slug": "long-march-2fg-chinese-reusable-space-vehicle-4",
      "launch_designator": "2026-024",
      "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
      },
      "last_updated": "2026-11-01T01:39:53Z",
      "net": "2026-02-07T03:58:00Z",
      "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
      },
      "window_end": "2026-02-07T04:07:00Z",
      "window_start": "2026-02-07T03:48:00Z",
      "image": {
        "id": 2580,
        "name": "Shenzhou 22 launch",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_20251129175823.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_thumbnail_20251129175823.jpeg",
        "credit": "Xinhua",
        "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": 88,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "abbrev": "CASC",
        "type": {
          "id": 1,
          "name": "Government"
        }
      },
      "rocket": {
        "id": 8911,
        "configuration": {
          "response_mode": "list",
          "id": 84,
          "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/84/?format=api",
          "name": "Long March 2F/G",
          "families": [
            {
              "response_mode": "list",
              "id": 106,
              "name": "Long March"
            },
            {
              "response_mode": "list",
              "id": 109,
              "name": "Long March 2"
            }
          ],
          "full_name": "Long March 2F/G",
          "variant": "F/G"
        }
      },
      "mission": {
        "id": 7502,
        "name": "Chinese Reusable Space Vehicle",
        "type": "Government/Top Secret",
        "description": "4th flight of the Chinese spaceplane capable of returning to Earth.",
        "image": null,
        "orbit": {
          "id": 8,
          "name": "Low Earth Orbit",
          "abbrev": "LEO",
          "celestial_body": {
            "response_mode": "list",
            "id": 1,
            "name": "Earth"
          }
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
      },
      "pad": {
        "id": 37,
        "url": "https://lldev.thespacedevs.com/2.3.0/pads/37/?format=api",
        "active": true,
        "agencies": [],
        "name": "Launch Area 91 (SLS-1 / 921)",
        "image": {
          "id": 1363,
          "name": "Long March 2F/G from LA-4 (Shenzhou 17)",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20231231163528.jpeg",
          "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192527.jpeg",
          "credit": "我们的太空",
          "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
          },
          "single_use": false,
          "variants": []
        },
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4",
        "map_url": "https://www.google.com/maps?q=40.957893,100.290944",
        "latitude": 40.957893,
        "longitude": 100.290944,
        "country": {
          "id": 6,
          "name": "China",
          "alpha_2_code": "CN",
          "alpha_3_code": "CHN",
          "nationality_name": "Chinese",
          "nationality_name_composed": "Sino"
        },
        "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_37_20200803143603.jpg",
        "total_launch_count": 29,
        "orbital_launch_attempt_count": 29,
        "fastest_turnaround": "P24DT12H26M59S",
        "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",
          "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",
            "total_attempted_launches": 7651,
            "successful_launches": 7094,
            "failed_launches": 557,
            "total_attempted_landings": 1384,
            "successful_landings": 1335,
            "failed_landings": 49
          },
          "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": 300,
          "total_landing_count": 3
        }
      },
      "webcast_live": false,
      "program": [],
      "orbital_launch_attempt_count": 7200,
      "location_launch_attempt_count": 277,
      "pad_launch_attempt_count": 28,
      "agency_launch_attempt_count": 577,
      "orbital_launch_attempt_count_year": 27,
      "location_launch_attempt_count_year": 4,
      "pad_launch_attempt_count_year": 1,
      "agency_launch_attempt_count_year": 7
    },
    "duration": "P266DT21H41M52.975449S",
    "turn_around_time": "P519DT2H48M",
    "response_mode": "detailed",
    "launch_crew": [],
    "onboard_crew": [],
    "landing_crew": [],
    "docking_events": []
  },
  "payloadflight": null
}