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/a927b2f9-f9a5-4196-9abb-2e275e4a6b96/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "a927b2f9-f9a5-4196-9abb-2e275e4a6b96",
  "url": "https://lldev.thespacedevs.com/2.2.0/launch/a927b2f9-f9a5-4196-9abb-2e275e4a6b96/?format=api",
  "slug": "pallas-1-demo-flight",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Pallas-1 | Demo Flight",
  "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-09-01T02:23:24Z",
  "updates": [
    {
      "id": 15995,
      "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Launch success.",
      "info_url": "https://m.weibo.cn/detail/5338281089963689",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-09-01T02:23:00Z"
    },
    {
      "id": 15958,
      "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "NET September 1 per NOTAMs; Assignment of this to the launch within the window is uncertain.",
      "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2818059#msg2818059",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-08-27T08:05:00Z"
    },
    {
      "id": 15741,
      "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Moved to NET August based on rumors.",
      "info_url": "https://x.com/raz_liu/status/2084104219351818280",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-08-05T00:07:00Z"
    },
    {
      "id": 13093,
      "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Added launch.",
      "info_url": "https://x.com/AJ_FI/status/1985669653163860087",
      "created_by": "Cosmic_Penguin",
      "created_on": "2025-12-01T16:44:00Z"
    }
  ],
  "net": "2026-09-01T02:00:00Z",
  "net_precision": {
    "id": 1,
    "name": "Minute",
    "abbrev": "MIN",
    "description": "The T-0 is accurate to the minute."
  },
  "window_end": "2026-09-01T04:09:00Z",
  "window_start": "2026-09-01T01:52:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 1021,
    "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1021/?format=api",
    "name": "Galactic Energy",
    "featured": false,
    "type": "Commercial",
    "country_code": "CHN",
    "abbrev": "GE",
    "description": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.",
    "administrator": null,
    "founding_year": "2018",
    "launchers": "Ceres-1 | Pallas-1",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 27,
    "consecutive_successful_launches": 3,
    "successful_launches": 24,
    "failed_launches": 3,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.galactic-energy.cn/index.php/En",
    "wiki_url": null,
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png"
  },
  "rocket": {
    "id": 8824,
    "configuration": {
      "id": 542,
      "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/542/?format=api",
      "name": "Pallas-1",
      "active": true,
      "reusable": true,
      "description": "Pallas-1 is a 2 stage, semi-reusable launch vehicle built by the Chinese private launch services provider Galactic Energy. Both stages are powered by the gas generator cycle rocket engine Welkin/Cangqiong 50 (CQ-50) using kerosene and liquid oxygen, with 7 engines on the 1st stage and 1 vacuum variant on the 2nd stage.\r\n\r\nIt can launch 7 tonnes to LEO and 3 tonnes to SSO when the 1st stage is recovered downrange.",
      "family": "",
      "full_name": "Pallas-1",
      "manufacturer": {
        "id": 1021,
        "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1021/?format=api",
        "name": "Galactic Energy",
        "featured": false,
        "type": "Commercial",
        "country_code": "CHN",
        "abbrev": "GE",
        "description": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.",
        "administrator": null,
        "founding_year": "2018",
        "launchers": "Ceres-1 | Pallas-1",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 27,
        "consecutive_successful_launches": 3,
        "successful_launches": 24,
        "failed_launches": 3,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.galactic-energy.cn/index.php/En",
        "wiki_url": null,
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png"
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 2,
      "max_stage": 3,
      "length": 49.6,
      "diameter": 3.35,
      "maiden_flight": "2026-09-01",
      "launch_cost": null,
      "launch_mass": 283,
      "leo_capacity": 7000,
      "gto_capacity": null,
      "to_thrust": 3435,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/pallas-1_y1_image_20260901030251.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Pallas-1",
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [
      {
        "id": 982,
        "type": "Core",
        "reused": false,
        "launcher_flight_number": 1,
        "launcher": {
          "id": 259,
          "url": "https://lldev.thespacedevs.com/2.2.0/launcher/259/?format=api",
          "details": "First stage booster used on the 1st flight of Galactic Energy's Pallas-1 rocket. No booster recovery was attempted.",
          "flight_proven": false,
          "serial_number": "Pallas1 F1",
          "status": "expended",
          "image_url": null,
          "successful_landings": 0,
          "attempted_landings": 0,
          "flights": 1,
          "last_launch_date": "2026-09-01T02:00:00Z",
          "first_launch_date": "2026-09-01T02:00:00Z"
        },
        "landing": {
          "id": 1916,
          "attempt": false,
          "success": null,
          "description": "The Pallas-1 first stage booster was expended.",
          "downrange_distance": null,
          "location": {
            "id": 12,
            "name": "Unknown",
            "abbrev": "N/A",
            "description": null,
            "location": null,
            "successful_landings": 0
          },
          "type": {
            "id": 8,
            "name": "Expended",
            "abbrev": "EXP",
            "description": "Vehicle did not perform any landing operations after launch"
          }
        },
        "previous_flight_date": null,
        "turn_around_time_days": null,
        "previous_flight": null
      }
    ],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7415,
    "name": "Demo Flight",
    "description": "First test launch of Galactic Energy’s Pallas-1 rocket, with a dummy payload on board.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 17,
      "name": "Sun-Synchronous Orbit",
      "abbrev": "SSO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 246,
    "url": "https://lldev.thespacedevs.com/2.2.0/pad/246/?format=api",
    "agency_id": 1021,
    "name": "Pallas-1 Launch Pad",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Pallas-1",
    "map_url": "https://www.google.com/maps?q=40.775962,100.107214",
    "latitude": "40.775962",
    "longitude": "100.107214",
    "location": {
      "id": 17,
      "url": "https://lldev.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-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
      "timezone_name": "Asia/Shanghai",
      "total_launch_count": 303,
      "total_landing_count": 3
    },
    "country_code": "CHN",
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_pallas-1_launch_pad_20251128223637.jpg",
    "total_launch_count": 1,
    "orbital_launch_attempt_count": 1
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/pallas-1_y1_image_20260901030251.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 7380,
  "location_launch_attempt_count": 294,
  "pad_launch_attempt_count": 1,
  "agency_launch_attempt_count": 25,
  "orbital_launch_attempt_count_year": 207,
  "location_launch_attempt_count_year": 21,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 3,
  "pad_turnaround": "P0D",
  "mission_patches": [
    {
      "id": 1338,
      "name": "Pallas-1 Y1 Mission Patch",
      "priority": 10,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/mission_patch_images/pallas-12520y1_mission_patch_20260805001638.png",
      "agency": {
        "id": 1021,
        "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1021/?format=api",
        "name": "Galactic Energy",
        "type": "Commercial"
      }
    }
  ],
  "type": "detailed"
}