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/74b3aa8f-dc54-43dd-b8dd-1dc62ccccfc4/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "74b3aa8f-dc54-43dd-b8dd-1dc62ccccfc4",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/74b3aa8f-dc54-43dd-b8dd-1dc62ccccfc4/?format=api",
  "launch_library_id": null,
  "slug": "soyuz-5-demo-flight",
  "name": "Soyuz-5 | Demo Flight",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2026-04-30T18:00:00Z",
  "window_end": "2026-04-30T21:00:00Z",
  "window_start": "2026-04-30T11:00:00Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 103,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/103/?format=api",
    "name": "RKK Energiya",
    "featured": false,
    "type": "Commercial",
    "country_code": "RUS",
    "abbrev": "RSC",
    "description": "",
    "administrator": null,
    "founding_year": null,
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 1,
    "consecutive_successful_launches": 1,
    "successful_launches": 1,
    "failed_launches": 0,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.energia.ru/english/",
    "wiki_url": "https://en.wikipedia.org/wiki/S.P._Korolev_Rocket_and_Space_Corporation_Energia",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rkk_energiya_lo_image_20250921093034.png",
    "image_url": null,
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rkk_energiya_so_image_20250921093044.png"
  },
  "rocket": {
    "id": 8701,
    "configuration": {
      "id": 521,
      "launch_library_id": null,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/521/?format=api",
      "name": "Soyuz-5",
      "description": "Soyuz-5, also named Irtysh is a planned Russian rocket that is being developed by JSC SRC Progress, formerly within \"Project Feniks.\" It will replace the capability of Zenit-2 and Proton Medium. It will initially be a two-stage rocket, but Soyuz 5 can be enhanced with an optional Blok DM-03 upper stage for geostationary missions.\r\n\r\nThe rocket is loosely based on the Zenit launch vehicle with a RD-171MV engine on the 1st stage, enlarged to 4.1 m in diameter, while the 2nd stage is powered by 2 RD-0124MS engines derived from engines used on the 3rd stage of the Soyuz-2.1b. The Soyuz-5 can lift 17 tonnes to a Low Earth orbit.",
      "family": "Soyuz-5",
      "full_name": "Soyuz-5",
      "manufacturer": {
        "id": 103,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/103/?format=api",
        "name": "RKK Energiya",
        "featured": false,
        "type": "Commercial",
        "country_code": "RUS",
        "abbrev": "RSC",
        "description": "",
        "administrator": null,
        "founding_year": null,
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 1,
        "consecutive_successful_launches": 1,
        "successful_launches": 1,
        "failed_launches": 0,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.energia.ru/english/",
        "wiki_url": "https://en.wikipedia.org/wiki/S.P._Korolev_Rocket_and_Space_Corporation_Energia",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rkk_energiya_lo_image_20250921093034.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/rkk_energiya_so_image_20250921093044.png"
      },
      "program": [],
      "variant": "",
      "alias": "Irtysh",
      "min_stage": 2,
      "max_stage": 3,
      "length": 65.258,
      "diameter": 4.1,
      "maiden_flight": "2026-04-30",
      "launch_mass": 525,
      "leo_capacity": 17000,
      "gto_capacity": 5000,
      "to_thrust": 7257,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz-5_at_baik_image_20260501030446.png",
      "info_url": "https://russianspaceweb.com/soyuz5-lv.html",
      "wiki_url": "https://en.wikipedia.org/wiki/Irtysh_(rocket)",
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7294,
    "launch_library_id": null,
    "name": "Demo Flight",
    "description": "Demonstration Flight for Russia's new Soyuz-5 launch vehicle, with a mass simulator on board. The launch was suborbital with the simulator splashing down in the Pacific Ocean.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 15,
      "name": "Suborbital",
      "abbrev": "Sub"
    }
  },
  "pad": {
    "id": 2,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/2/?format=api",
    "agency_id": null,
    "name": "45/1",
    "info_url": null,
    "wiki_url": "",
    "map_url": "https://www.google.com/maps?q=45.943492,63.653014",
    "latitude": "45.943492",
    "longitude": "63.653014",
    "location": {
      "id": 15,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/15/?format=api",
      "name": "Baikonur Cosmodrome, Republic of Kazakhstan",
      "country_code": "KAZ",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg",
      "total_launch_count": 1563,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_2_20200803143256.jpg",
    "total_launch_count": 47
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 10,
      "title": "Экспертный комментарий пуска ракеты «Союз-5»",
      "description": "30 апреля в 21:00 мск с 45-й площадки Байконура состоялся пуск новой российской ракеты-носителя среднего класса «Союз-5».\n\n«Союз-5» — ракета-носитель с самым мощным в мире жидкостным ракетным двигателем.\n\nЭто первый старт ракеты нового поколения в рамках лётно-конструкторских испытаний.\n\nПервая и вторая ступени «Союза-5» отработали штатно, габаритно-массовый макет выведен на расчётную суборбитальную траекторию с последующим падением в заранее закрытом для судоходства и авиации районе в акватории Тихого океана.\n\nСайт Роскосмоса: https://www.roscosmos.ru/\nРоскосмос в социальных сетях: \nVk: https://vk.com/roscosmos\nOk: https://ok.ru/roscosmos  \nTelegram: https://t.me/roscosmos_gk \nRutube: https://rutube.ru/channel/770606/\n\nНовый telegram-канал о путешествиях на космодромы: https://t.me/c...",
      "feature_image": "https://i.ytimg.com/vi/eeyJIut4NNA/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=eeyJIut4NNA"
    }
  ],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz-5_at_baik_image_20260501030446.png",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": null,
  "location_launch_attempt_count": 1563,
  "pad_launch_attempt_count": 47,
  "agency_launch_attempt_count": 1,
  "orbital_launch_attempt_count_year": null,
  "location_launch_attempt_count_year": 4,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1
}