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/0ab0bc54-1988-48ce-a40a-8554c137b534/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "0ab0bc54-1988-48ce-a40a-8554c137b534",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/0ab0bc54-1988-48ce-a40a-8554c137b534/?format=api",
  "launch_library_id": 1319,
  "slug": "soyuz-stbfregat-mt-metop-c",
  "name": "Soyuz STB/Fregat-MT | MetOp-C",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2018-11-07T00:47:27Z",
  "window_end": "2018-11-07T00:47:27Z",
  "window_start": "2018-11-07T00:47:27Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": null,
  "hashtag": "#MetOpC",
  "launch_service_provider": {
    "id": 115,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/115/?format=api",
    "name": "Arianespace",
    "featured": true,
    "type": "Commercial",
    "country_code": "FRA",
    "abbrev": "ASA",
    "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
    "administrator": "CEO: David Cavaillolès",
    "founding_year": "1980",
    "launchers": "Ariane | Vega",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 328,
    "consecutive_successful_launches": 16,
    "successful_launches": 313,
    "failed_launches": 15,
    "pending_launches": 51,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.arianespace.com",
    "wiki_url": "https://en.wikipedia.org/wiki/Arianespace",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane_64_lifto_image_20260213070745.jpg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg"
  },
  "rocket": {
    "id": 2152,
    "configuration": {
      "id": 72,
      "launch_library_id": 96,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/72/?format=api",
      "name": "Soyuz STB",
      "description": "The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage. First launch took place from Plesetsk Cosmodrome Site 43 on 26 July 2008 with a classified military payload.\r\n\r\nThe 2.1b/ST version is sometimes called Soyuz ST-B.",
      "family": "Soyuz",
      "full_name": "Soyuz STB Fregat-MT",
      "manufacturer": {
        "id": 111,
        "url": "https://lldev.thespacedevs.com/2.0.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-dev.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png",
        "image_url": null,
        "nation_url": null
      },
      "program": [],
      "variant": "Fregat-MT",
      "alias": "",
      "min_stage": 3,
      "max_stage": 3,
      "length": 46.3,
      "diameter": 2.95,
      "maiden_flight": "2012-10-12",
      "launch_mass": 310,
      "leo_capacity": 8200,
      "gto_capacity": 3250,
      "to_thrust": null,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz2520stb_image_20191201201634.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2#Soyuz-2.1b",
      "total_launch_count": 5,
      "consecutive_successful_launches": 5,
      "successful_launches": 5,
      "failed_launches": 0,
      "pending_launches": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 707,
    "launch_library_id": 833,
    "name": "MetOp-C",
    "description": "MetOp is a series of three polar orbiting meteorological satellites developed by the European Space Agency (ESA).",
    "launch_designator": null,
    "type": "Earth Science",
    "orbit": {
      "id": 17,
      "name": "Sun-Synchronous Orbit",
      "abbrev": "SSO"
    }
  },
  "pad": {
    "id": 81,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/81/?format=api",
    "agency_id": 115,
    "name": "Soyuz Launch Complex",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Ensemble_de_Lancement_Soyouz",
    "map_url": "https://www.google.com/maps?q=5.3019,-52.8346",
    "latitude": "5.3019",
    "longitude": "-52.8346",
    "location": {
      "id": 13,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/13/?format=api",
      "name": "Guiana Space Centre, French Guiana",
      "country_code": "GUF",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
      "total_launch_count": 336,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_81_20200803143601.jpg",
    "total_launch_count": 26
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 0,
      "title": "Arianespace Flight VS19 – Successful Soyuz Launch",
      "description": "Arianespace has successfully launched the Metop-C satellite for EUMETSAT, the European Organisation for the Exploitation of Meteorological Satellites.\n\nArianespace’s eighth launch of the year, and the...",
      "feature_image": "https://i.ytimg.com/vi/W-HR0Na34Hs/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=W-HR0Na34Hs"
    },
    {
      "priority": 0,
      "title": "Flight VS19 – Metop-C | Soyuz Launch | Arianespace",
      "description": "Arianespace has successfully launched the Metop-C satellite for EUMETSAT, the European Organisation for the Exploitation of Meteorological Satellites.\n\nArianespace’s eighth launch of the year, and the...",
      "feature_image": "https://i.ytimg.com/vi/1hMEU5x2jFg/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=1hMEU5x2jFg"
    },
    {
      "priority": 0,
      "title": "Flight VS19 | Soyuz Best of Liftoff | Arianespace",
      "description": "Arianespace has successfully launched the Metop-C satellite for EUMETSAT, the European Organisation for the Exploitation of Meteorological Satellites.\n\nArianespace’s eighth launch of the year, and the...",
      "feature_image": "https://i.ytimg.com/vi/FTHzO8F6NvA/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=FTHzO8F6NvA"
    },
    {
      "priority": 0,
      "title": "Arianespace - VS19 Successful Launch",
      "description": "For its eighth launch of the year, and the second Soyuz liftoff from the Guiana Space Center (CSG) in French Guiana in 2018, Arianespace will orbit Metop-C for EUMETSAT, the European Organisation for ...",
      "feature_image": "https://i.ytimg.com/vi/zJ9FRIyaL5I/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=zJ9FRIyaL5I"
    },
    {
      "priority": 0,
      "title": "Soyouz VS19 launch with MetOp-C (IASI) on November 6-7, 2018",
      "description": "Soyouz rocket launch with the Metop-C satellite and french meteorological instrument IASI, from the Guiana Space Center in the night of 6 to 7 November 2018. Liftoff at 21:47 (Guiana time) - 1:47 (Par...",
      "feature_image": "https://i.ytimg.com/vi/yCYGl0mYG-4/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=yCYGl0mYG-4"
    }
  ],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz2520stb_image_20191201201634.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 5795,
  "location_launch_attempt_count": 285,
  "pad_launch_attempt_count": 18,
  "agency_launch_attempt_count": 270,
  "orbital_launch_attempt_count_year": 89,
  "location_launch_attempt_count_year": 8,
  "pad_launch_attempt_count_year": 2,
  "agency_launch_attempt_count_year": 8
}