GET

Launch Instance

AN API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX

GET Return a list of all Launch objects.

FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'

MODE 'normal', 'list', 'detailed'

EXAMPLE ?mode=list

SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.

EXAMPLE - ?search=SpaceX

GET /2.2.0/launch/ef02e2cf-e617-4b38-a526-951ac9204b0a/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "ef02e2cf-e617-4b38-a526-951ac9204b0a",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/ef02e2cf-e617-4b38-a526-951ac9204b0a/?format=api",
  "slug": "zhuque-3-flight-2",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Zhuque-3 | Flight 2",
  "status": {
    "id": 2,
    "name": "To Be Determined",
    "abbrev": "TBD",
    "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
  },
  "last_updated": "2026-07-10T14:38:03Z",
  "updates": [
    {
      "id": 15525,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Added launch.",
      "info_url": "https://x.com/raz_liu/status/2075563034484113602",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-07-10T14:38:00Z"
    }
  ],
  "net": "2026-08-31T00:00:00Z",
  "net_precision": {
    "id": 7,
    "name": "Month",
    "abbrev": "M",
    "description": "The T-0 is expected in the given month."
  },
  "window_end": "2026-08-31T00:00:00Z",
  "window_start": "2026-08-31T00:00:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 259,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
    "name": "LandSpace",
    "featured": false,
    "type": "Commercial",
    "country_code": "CHN",
    "abbrev": "LS",
    "description": "LandSpace is a Chinese private space launch company based in Beijing. It was founded in 2015 by Tsinghua University alumni Zhang Changwu.",
    "administrator": "Founder: Zhang Changwu",
    "founding_year": "2015",
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 10,
    "consecutive_successful_launches": 3,
    "successful_launches": 7,
    "failed_launches": 3,
    "pending_launches": 1,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 1,
    "attempted_landings": 1,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_logo_20220822100731.png",
    "image_url": null,
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_nation_20230702184353.png"
  },
  "rocket": {
    "id": 9085,
    "configuration": {
      "id": 539,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/539/?format=api",
      "name": "Zhuque-3",
      "active": true,
      "reusable": true,
      "description": "Zhuque-3 (ZQ-3) is a reusable orbital launch vehicle developed by Chinese private company LandSpace. The rocket is built using stainless steel and shares the same series of gas generator cycle methane/liquid oxygen powered rocket engines as in the currently active ZQ-2E rocket.\r\n\r\nThe first stage uses 9 TQ-12 engines (initially the TQ-12A, then upgraded TQ-12B) while the second stage uses 1 TQ-15 engine (TQ-15A, then TQ-15B).\r\n\r\nOn launch missions where the first stage is recovered, it will land on a down-range landing pad located in Minqin County, Gansu Province.",
      "family": "Zhuque",
      "full_name": "Zhuque-3",
      "manufacturer": {
        "id": 259,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
        "name": "LandSpace",
        "featured": false,
        "type": "Commercial",
        "country_code": "CHN",
        "abbrev": "LS",
        "description": "LandSpace is a Chinese private space launch company based in Beijing. It was founded in 2015 by Tsinghua University alumni Zhang Changwu.",
        "administrator": "Founder: Zhang Changwu",
        "founding_year": "2015",
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 10,
        "consecutive_successful_launches": 3,
        "successful_launches": 7,
        "failed_launches": 3,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 1,
        "attempted_landings": 1,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_logo_20220822100731.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_nation_20230702184353.png"
      },
      "program": [],
      "variant": "",
      "alias": "ZQ-3",
      "min_stage": 2,
      "max_stage": 2,
      "length": 76.6,
      "diameter": 4.5,
      "maiden_flight": "2025-12-03",
      "launch_cost": null,
      "launch_mass": 660,
      "leo_capacity": 21300,
      "gto_capacity": null,
      "to_thrust": 9000,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zq-3_flight_1_l_image_20251203064230.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Zhuque-3",
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 1,
      "attempted_landings": 1,
      "successful_landings": 0,
      "failed_landings": 1,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [
      {
        "id": 961,
        "type": "Core",
        "reused": null,
        "launcher_flight_number": null,
        "launcher": {
          "id": 242,
          "url": "https://ll.thespacedevs.com/2.2.0/launcher/242/?format=api",
          "details": "Booster serial number unknown.",
          "flight_proven": false,
          "serial_number": "UnknownZQ3",
          "status": "N/A",
          "image_url": null,
          "successful_landings": null,
          "attempted_landings": null,
          "flights": null,
          "last_launch_date": null,
          "first_launch_date": null
        },
        "landing": {
          "id": 1891,
          "attempt": true,
          "success": null,
          "description": "The Zhuque-3 first stage booster will attempt to land on its downrange landing pad.",
          "downrange_distance": 390.0,
          "location": {
            "id": 60,
            "name": "Zhuque-3 Landing Site",
            "abbrev": "ZQ-3 LZ",
            "description": "Landing site for first stage boosters of LandSpace’s Zhuque-3 rocket at Minqin County, Gansu Province, China.",
            "location": {
              "id": 17,
              "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api",
              "name": "Jiuquan Satellite Launch Center, People's Republic of China",
              "country_code": "CHN",
              "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).",
              "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
              "timezone_name": "Asia/Shanghai",
              "total_launch_count": 291,
              "total_landing_count": 2
            },
            "successful_landings": 0
          },
          "type": {
            "id": 9,
            "name": "Vertical Landing",
            "abbrev": "VL",
            "description": "Vertical landing using engines"
          }
        },
        "previous_flight_date": null,
        "turn_around_time_days": null,
        "previous_flight": null
      }
    ],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7680,
    "name": "Flight 2",
    "description": "Second test launch of LandSpace’s ZQ-3 rocket. Payload identities are TBD.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 8,
      "name": "Low Earth Orbit",
      "abbrev": "LEO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 243,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/243/?format=api",
    "agency_id": 259,
    "name": "Launch Area 96B",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Zhuque-3",
    "map_url": "https://www.google.com/maps?q=40.92017,100.25129",
    "latitude": "40.92017",
    "longitude": "100.25129",
    "location": {
      "id": 17,
      "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api",
      "name": "Jiuquan Satellite Launch Center, People's Republic of China",
      "country_code": "CHN",
      "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).",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
      "timezone_name": "Asia/Shanghai",
      "total_launch_count": 291,
      "total_landing_count": 2
    },
    "country_code": "CHN",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_area_96b_20251128220544.jpg",
    "total_launch_count": 1,
    "orbital_launch_attempt_count": 1
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zq-3_flight_1_l_image_20251203064230.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 7370,
  "location_launch_attempt_count": 293,
  "pad_launch_attempt_count": 2,
  "agency_launch_attempt_count": 11,
  "orbital_launch_attempt_count_year": 197,
  "location_launch_attempt_count_year": 20,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 3,
  "pad_turnaround": "P270DT20H",
  "mission_patches": [],
  "type": "detailed"
}