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/31a2227b-47b5-4167-b663-3de1aabde88f/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "31a2227b-47b5-4167-b663-3de1aabde88f",
  "url": "https://ll.thespacedevs.com/2.0.0/launch/31a2227b-47b5-4167-b663-3de1aabde88f/?format=api",
  "launch_library_id": null,
  "slug": "long-march-2csd-iridium-mfs-1-2",
  "name": "Long March 2C/SD | Iridium MFS 1 & 2",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "1997-09-01T14:00:15Z",
  "window_end": "1997-09-01T14:00:15Z",
  "window_start": "1997-09-01T14:00:15Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 189,
    "url": "https://ll.thespacedevs.com/2.0.0/agencies/189/?format=api",
    "name": "China Aerospace Corporation",
    "featured": false,
    "type": "Government",
    "country_code": "CHN",
    "abbrev": "CASC",
    "description": null,
    "administrator": null,
    "founding_year": null,
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 27,
    "consecutive_successful_launches": 15,
    "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.spacechina.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
    "logo_url": null,
    "image_url": null,
    "nation_url": null
  },
  "rocket": {
    "id": 6800,
    "configuration": {
      "id": 267,
      "launch_library_id": null,
      "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/267/?format=api",
      "name": "Long March 2C/SD",
      "description": "The Long March 2C is a family of expendable launch vehicles made and operated by China. It is a two stage launch vehicle with storable propellants, consisting of Nitrogen Tetroxide and Unsymmetrical Dimethylhydrazine.\r\n\r\nThe 2C/SD variant has an additional \"Smart Dispenser\" upper stage for multiple payloads.",
      "family": "Long March",
      "full_name": "Long March 2C/SD",
      "manufacturer": {
        "id": 88,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "featured": true,
        "type": "Government",
        "country_code": "CHN",
        "abbrev": "CASC",
        "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": "",
        "launch_library_url": null,
        "total_launch_count": 621,
        "consecutive_successful_launches": 12,
        "successful_launches": 605,
        "failed_launches": 16,
        "pending_launches": 7,
        "consecutive_successful_landings": 1,
        "successful_landings": 1,
        "failed_landings": 1,
        "attempted_landings": 2,
        "info_url": "https://english.spacechina.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png"
      },
      "program": [],
      "variant": "C/SD",
      "alias": "",
      "min_stage": 3,
      "max_stage": 3,
      "length": 42.0,
      "diameter": 3.35,
      "maiden_flight": "1997-09-01",
      "launch_mass": 192,
      "leo_capacity": 3850,
      "gto_capacity": null,
      "to_thrust": 2786,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2c-i_image_20210908194304.jpeg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Long_March_2C",
      "total_launch_count": 7,
      "consecutive_successful_launches": 7,
      "successful_launches": 7,
      "failed_launches": 0,
      "pending_launches": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 5190,
    "launch_library_id": null,
    "name": "Iridium MFS 1 & 2",
    "description": "The Iridium-MFS payloads were mass models of the Iridium communications satellites. Two were launched to test the new CZ-2C (2) SD launch vehicle and the payload dispenser.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 8,
      "name": "Low Earth Orbit",
      "abbrev": "LEO"
    }
  },
  "pad": {
    "id": 33,
    "url": "https://ll.thespacedevs.com/2.0.0/pad/33/?format=api",
    "agency_id": null,
    "name": "Launch Complex 7",
    "info_url": null,
    "wiki_url": null,
    "map_url": "https://www.google.com/maps?q=38.8489311,111.6079339",
    "latitude": "38.8489311",
    "longitude": "111.6079339",
    "location": {
      "id": 19,
      "url": "https://ll.thespacedevs.com/2.0.0/location/19/?format=api",
      "name": "Taiyuan Satellite Launch Center, People's Republic of China",
      "country_code": "CHN",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_19_20200803142421.jpg",
      "total_launch_count": 163,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_33_20200803143335.jpg",
    "total_launch_count": 32
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2c-i_image_20210908194304.jpeg",
  "infographic": null,
  "program": [
    {
      "id": 28,
      "url": "https://ll.thespacedevs.com/2.0.0/program/28/?format=api",
      "name": "Iridium Constellation",
      "description": "The Iridium satellite constellation provides L band voice and data information coverage to satellite phones, satellite messenger communication devices and integrated transceivers.",
      "agencies": [
        {
          "id": 202,
          "url": "https://ll.thespacedevs.com/2.0.0/agencies/202/?format=api",
          "name": "Iridium Communications",
          "type": "Commercial"
        }
      ],
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iridium2520con_program_20231228184831.jpeg",
      "start_date": "1997-05-05T00:00:00Z",
      "end_date": null,
      "info_url": "https://iridium.com/",
      "wiki_url": "https://en.wikipedia.org/wiki/Iridium_satellite_constellation"
    }
  ],
  "orbital_launch_attempt_count": 4168,
  "location_launch_attempt_count": 3,
  "pad_launch_attempt_count": 3,
  "agency_launch_attempt_count": 17,
  "orbital_launch_attempt_count_year": 50,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 4
}