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

EXAMPLE - /launch// 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'

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.0.0/launch/c6cd904e-9770-474d-912a-e7bdfd6ca953/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "c6cd904e-9770-474d-912a-e7bdfd6ca953",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/c6cd904e-9770-474d-912a-e7bdfd6ca953/?format=api",
  "launch_library_id": null,
  "slug": "vulcan-vc4s-nrol-88",
  "name": "Vulcan VC4S | NROL-88",
  "status": {
    "id": 2,
    "name": "TBD"
  },
  "net": "2027-06-30T00:00:00Z",
  "window_end": "2027-06-30T00:00:00Z",
  "window_start": "2027-06-30T00:00:00Z",
  "inhold": false,
  "tbdtime": true,
  "tbddate": true,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 124,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/124/?format=api",
    "name": "United Launch Alliance",
    "featured": true,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "ULA",
    "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
    "administrator": "Interim CEO: John Elbon",
    "founding_year": "2006",
    "launchers": "Atlas | Delta | Vulcan",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 175,
    "consecutive_successful_launches": 175,
    "successful_launches": 175,
    "failed_launches": 0,
    "pending_launches": 36,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.ulalaunch.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/United_Launch_Alliance",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
  },
  "rocket": {
    "id": 8753,
    "configuration": {
      "id": 516,
      "launch_library_id": null,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/516/?format=api",
      "name": "Vulcan VC4S",
      "description": "Vulcan Centaur is a two-stage-to-orbit, heavy-lift launch vehicle under development by United Launch Alliance (ULA) since 2014. It is principally designed to meet launch demands for the U.S. government's National Security Space Launch (NSSL) program for use by the United States Space Force and U.S. intelligence agencies for national security satellite launches. It will replace both of ULA's existing launchers (Atlas V and Delta IV Heavy) in this role, as these launchers are retiring.",
      "family": "Vulcan",
      "full_name": "Vulcan VC4S",
      "manufacturer": {
        "id": 124,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/124/?format=api",
        "name": "United Launch Alliance",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "ULA",
        "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
        "administrator": "Interim CEO: John Elbon",
        "founding_year": "2006",
        "launchers": "Atlas | Delta | Vulcan",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 175,
        "consecutive_successful_launches": 175,
        "successful_launches": 175,
        "failed_launches": 0,
        "pending_launches": 36,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.ulalaunch.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/United_Launch_Alliance",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
      },
      "program": [],
      "variant": "VC4S",
      "alias": "",
      "min_stage": null,
      "max_stage": null,
      "length": null,
      "diameter": null,
      "maiden_flight": "2025-08-13",
      "launch_mass": null,
      "leo_capacity": null,
      "gto_capacity": null,
      "to_thrust": null,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vulcan_vc4s_v-0_image_20250812014341.jpeg",
      "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur",
      "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur",
      "total_launch_count": 2,
      "consecutive_successful_launches": 2,
      "successful_launches": 2,
      "failed_launches": 0,
      "pending_launches": 1
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7344,
    "launch_library_id": null,
    "name": "NROL-88",
    "description": "Classified payload for the US National Reconnaissance Office",
    "launch_designator": null,
    "type": "Government/Top Secret",
    "orbit": {
      "id": 25,
      "name": "Unknown",
      "abbrev": "N/A"
    }
  },
  "pad": {
    "id": 29,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/29/?format=api",
    "agency_id": null,
    "name": "Space Launch Complex 41",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41",
    "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644",
    "latitude": "28.58341025",
    "longitude": "-80.58303644",
    "location": {
      "id": 12,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/12/?format=api",
      "name": "Cape Canaveral SFS, FL, USA",
      "country_code": "USA",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
      "total_launch_count": 1119,
      "total_landing_count": 75
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg",
    "total_launch_count": 125
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vulcan_vc4s_v-0_image_20250812014341.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 7536,
  "location_launch_attempt_count": 1182,
  "pad_launch_attempt_count": 141,
  "agency_launch_attempt_count": 198,
  "orbital_launch_attempt_count_year": 38,
  "location_launch_attempt_count_year": 13,
  "pad_launch_attempt_count_year": 2,
  "agency_launch_attempt_count_year": 2
}