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/e3848883-9205-4bc9-86c1-b6e2d14593a8/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "e3848883-9205-4bc9-86c1-b6e2d14593a8",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/e3848883-9205-4bc9-86c1-b6e2d14593a8/?format=api",
  "slug": "soyuz-21b-persona-kosmos-2486",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Soyuz 2.1b | Persona (Kosmos-2486)",
  "status": {
    "id": 3,
    "name": "Launch Successful",
    "abbrev": "Success",
    "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
  },
  "last_updated": "2023-06-14T04:10:56Z",
  "updates": [],
  "net": "2013-06-07T18:37:59Z",
  "net_precision": null,
  "window_end": "2013-06-07T18:37:59Z",
  "window_start": "2013-06-07T18:37:59Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": null,
  "hashtag": null,
  "launch_service_provider": {
    "id": 163,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/163/?format=api",
    "name": "Russian Aerospace Defence Forces",
    "featured": false,
    "type": "Government",
    "country_code": "RUS",
    "abbrev": "VKO",
    "description": null,
    "administrator": null,
    "founding_year": null,
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 22,
    "consecutive_successful_launches": 17,
    "successful_launches": 20,
    "failed_launches": 2,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.eng.mil.ru/en/structure/forces/cosmic.htm",
    "wiki_url": "https://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces",
    "logo_url": null,
    "image_url": null,
    "nation_url": null
  },
  "rocket": {
    "id": 1681,
    "configuration": {
      "id": 15,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/15/?format=api",
      "name": "Soyuz 2.1b",
      "active": true,
      "reusable": false,
      "description": "Soyuz-2 is the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit.  The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage.",
      "family": "Soyuz",
      "full_name": "Soyuz 2.1b",
      "manufacturer": {
        "id": 111,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/111/?format=api",
        "name": "Progress Rocket Space Center",
        "featured": false,
        "type": "Commercial",
        "country_code": "RUS",
        "abbrev": "PRSC",
        "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.",
        "administrator": "CEO: Dmitry Baranov",
        "founding_year": "1996",
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 45,
        "consecutive_successful_launches": 3,
        "successful_launches": 44,
        "failed_launches": 1,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://en.samspace.ru/",
        "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png",
        "image_url": null,
        "nation_url": null
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 2,
      "max_stage": 3,
      "length": 46.3,
      "diameter": 2.95,
      "maiden_flight": "2008-07-26",
      "launch_cost": "80000000",
      "launch_mass": 312,
      "leo_capacity": 8200,
      "gto_capacity": 3250,
      "to_thrust": null,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg",
      "info_url": null,
      "wiki_url": "http://en.wikipedia.org/wiki/Soyuz-2_(rocket)",
      "total_launch_count": 23,
      "consecutive_successful_launches": 23,
      "successful_launches": 23,
      "failed_launches": 0,
      "pending_launches": 1,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": null,
  "pad": {
    "id": 85,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/85/?format=api",
    "agency_id": 163,
    "name": "43/4 (43R)",
    "description": "",
    "info_url": null,
    "wiki_url": null,
    "map_url": "https://www.google.com/maps?q=62.92883,40.457098",
    "latitude": "62.92883",
    "longitude": "40.457098",
    "location": {
      "id": 6,
      "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api",
      "name": "Plesetsk Cosmodrome, Russian Federation",
      "country_code": "RUS",
      "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg",
      "timezone_name": "Europe/Moscow",
      "total_launch_count": 1683,
      "total_landing_count": 0
    },
    "country_code": "RUS",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_85_20200803143554.jpg",
    "total_launch_count": 327,
    "orbital_launch_attempt_count": 327
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "vexed123",
      "title": "Soyuz 2.1B Launch - Amazing Footage",
      "description": "Please Subscribe to my channel @ http://www.youtube.com/user/vexed123\nAmazing footage of the Soyuz 2.1B rocket launching in space, carrying an advanced imaging satellite for the Russian ministry of de...",
      "feature_image": "https://i.ytimg.com/vi/wDvxVf1Fb38/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=wDvxVf1Fb38",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 1,
        "name": "English",
        "code": "en"
      },
      "start_time": "2013-06-16T21:55:57Z",
      "end_time": "2013-06-16T21:58:01Z"
    }
  ],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 5297,
  "location_launch_attempt_count": 1589,
  "pad_launch_attempt_count": 272,
  "agency_launch_attempt_count": 7,
  "orbital_launch_attempt_count_year": 29,
  "location_launch_attempt_count_year": 3,
  "pad_launch_attempt_count_year": 2,
  "agency_launch_attempt_count_year": 3,
  "pad_turnaround": "P42DT13H14M18S",
  "mission_patches": [],
  "type": "detailed"
}