GET

Launch Instance

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/69ebbcd2-b257-4070-9ef9-21e7d1f8a883/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "69ebbcd2-b257-4070-9ef9-21e7d1f8a883",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/69ebbcd2-b257-4070-9ef9-21e7d1f8a883/?format=api",
  "launch_library_id": null,
  "slug": "h3-24-martian-moons-exploration-mmx",
  "name": "H3-24 | Martian Moons eXploration (MMX)",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2026-10-19T19:41:03Z",
  "window_end": "2026-10-19T19:41:03Z",
  "window_start": "2026-10-19T19:41:03Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 98,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/98/?format=api",
    "name": "Mitsubishi Heavy Industries",
    "featured": false,
    "type": "Commercial",
    "country_code": "JPN",
    "abbrev": "MHI",
    "description": "Mitsubishi Heavy Industries, Ltd. is a Japanese multinational engineering, electrical equipment and electronics company headquartered in Tokyo, Japan. MHI is one of the core companies of the Mitsubishi Group.\r\n\r\nMHI's products include aerospace components, air conditioners, aircraft, automotive components, forklift trucks, hydraulic equipment, machine tools, missiles, power generation equipment, printing machines, ships and space launch vehicles. Through its defense-related activities, it is the world's 23rd-largest defense contractor measured by 2011 defense revenues and the largest based in Japan.",
    "administrator": "President: Seiji Izumisawa",
    "founding_year": "1884",
    "launchers": "H-I, H-II, H-III",
    "spacecraft": "Kounotori | HTV",
    "launch_library_url": null,
    "total_launch_count": 59,
    "consecutive_successful_launches": 3,
    "successful_launches": 57,
    "failed_launches": 2,
    "pending_launches": 12,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.mhi.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg"
  },
  "rocket": {
    "id": 7769,
    "configuration": {
      "id": 204,
      "launch_library_id": 233,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/204/?format=api",
      "name": "H3-24",
      "description": "The H3 Launch Vehicle is a Japanese expendable launch system.\r\nEach H3 booster configuration has a two-digit and a letter designation that indicates the features of that configuration. The first digit represents the number of LE-9 engines on the main stage, either \"2\" or \"3\". The second digit indicates the number of SRB-3 solid rocket boosters attached to the base of the rocket, and can be \"0\", \"2\" or \"4\". All layouts of solid boosters are symmetrical. The letter in the end shows the length of the payload fairing, either short \"S\" or long \"L\". For example, an H3-24L has two engines, four solid rocket boosters, and a long fairing, whereas an H3-30S has three engines, no solid rocket boosters, and a short fairing.",
      "family": "H3",
      "full_name": "H3-24",
      "manufacturer": {
        "id": 98,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/98/?format=api",
        "name": "Mitsubishi Heavy Industries",
        "featured": false,
        "type": "Commercial",
        "country_code": "JPN",
        "abbrev": "MHI",
        "description": "Mitsubishi Heavy Industries, Ltd. is a Japanese multinational engineering, electrical equipment and electronics company headquartered in Tokyo, Japan. MHI is one of the core companies of the Mitsubishi Group.\r\n\r\nMHI's products include aerospace components, air conditioners, aircraft, automotive components, forklift trucks, hydraulic equipment, machine tools, missiles, power generation equipment, printing machines, ships and space launch vehicles. Through its defense-related activities, it is the world's 23rd-largest defense contractor measured by 2011 defense revenues and the largest based in Japan.",
        "administrator": "President: Seiji Izumisawa",
        "founding_year": "1884",
        "launchers": "H-I, H-II, H-III",
        "spacecraft": "Kounotori | HTV",
        "launch_library_url": null,
        "total_launch_count": 59,
        "consecutive_successful_launches": 3,
        "successful_launches": 57,
        "failed_launches": 2,
        "pending_launches": 12,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.mhi.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg"
      },
      "program": [],
      "variant": "24",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 63.0,
      "diameter": 5.27,
      "maiden_flight": "2025-10-26",
      "launch_mass": null,
      "leo_capacity": null,
      "gto_capacity": 7900,
      "to_thrust": 12142,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/h3-24_liftoff__image_20251028184029.jpeg",
      "info_url": "https://global.jaxa.jp/press/2015/07/20150702_h3.html",
      "wiki_url": "https://en.wikipedia.org/wiki/H3_(rocket)",
      "total_launch_count": 2,
      "consecutive_successful_launches": 2,
      "successful_launches": 2,
      "failed_launches": 0,
      "pending_launches": 4
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 6287,
    "launch_library_id": null,
    "name": "Martian Moons eXploration (MMX)",
    "description": "MMX is a Japanese scientific mission to land on Phobos, one of the two moons of Mars, to collect samples before bringing them back to Earth.\r\n\r\nThe mission includes a small French/German rover to explore the surface of Phobos.",
    "launch_designator": null,
    "type": "Planetary Science",
    "orbit": {
      "id": 19,
      "name": "Mars Orbit",
      "abbrev": "Mars"
    }
  },
  "pad": {
    "id": 209,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/209/?format=api",
    "agency_id": 37,
    "name": "Yoshinobu Launch Complex LP-2",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex",
    "map_url": "https://www.google.com/maps?q=30.400938,130.97564",
    "latitude": "30.400938",
    "longitude": "130.97564",
    "location": {
      "id": 26,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/26/?format=api",
      "name": "Tanegashima Space Center, Japan",
      "country_code": "JPN",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg",
      "total_launch_count": 100,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg",
    "total_launch_count": 19
  },
  "infoURLs": [
    {
      "priority": 10,
      "title": "Request Rejected",
      "description": "",
      "feature_image": null,
      "url": "https://www.mmx.jaxa.jp/en/"
    }
  ],
  "vidURLs": [
    {
      "priority": 10,
      "title": "Launch live streaming of Martian Moons eXploration (MMX)/H3 Launch Vehicle flight No.10(English)",
      "description": "JAXA will livestream the launch of the Martian Moons eXploration (MMX) spacecraft aboard H3 Launch Vehicle flight No.10 (H3 F10).\n\nBroadcast Start Time: October 20, 2026, around 03:45 JST \nLaunch Time: October 20, 2026, at 04:41:03 JST \nLaunch Site: Tanegashima Space Center, Yoshinobu Launch Complex \nAll times are in Japan Standard Time (24-hour format). \n\n▼Japanese Live Stream（日本語の配信はこちら） \nLaunch live streaming of Martian Moons eXploration (MMX)/H3 Launch Vehicle flight No.10(English)\nhttps://www.youtube.com/live/sZGyK9jfoy4\n\n▼Related Links \nhttps://www.youtube.com/user/jaxachannel\nhttps://www.youtube.com/@JAXA-LiveEvent\nhttps://www.jaxa.jp/\nhttps://global.jaxa.jp/",
      "feature_image": "https://i.ytimg.com/vi/Fn6gzuGa-6c/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=Fn6gzuGa-6c"
    },
    {
      "priority": 11,
      "title": "火星衛星探査機(MMX)/H3ロケット10号機打上げライブ中継",
      "description": "火星衛星探査機(MMX)/H3ロケット10号機の打上げライブ中継です。 \n\n番組放送開始予定：2026年10月20日 3時45分頃 \n打上げ日時：2026年10月20日 4時41分03秒\n打上げ場所：種子島宇宙センター　大型ロケット発射場 \n※日本標準時、24時間表記  \n\n▼英語同時通訳付き配信はこちら（English Live Stream） \nLaunch live streaming of Martian Moons eXploration (MMX)/H3 Launch Vehicle flight No.10(English)\nhttps://www.youtube.com/live/Fn6gzuGa-6c\n\n▼JAXA公式チャンネルはこちら\nhttps://www.youtube.com/user/jaxachannel\nhttps://www.youtube.com/@JAXA-LiveEvent\n\n▼JAXA（国立研究開発法人宇宙航空研究開発機構/Japan Aerospace Exploration Agency）\nhttps://www.jaxa.jp/\nhttps://global.jaxa.jp/",
      "feature_image": "https://i.ytimg.com/vi/sZGyK9jfoy4/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=sZGyK9jfoy4"
    },
    {
      "priority": 12,
      "title": "2026.10.20　3:30～ H３ロケット10号機 「火星衛星探査機（MMX）」打上げ　H3 Rocket F10 Launch",
      "description": "H3ロケット10号機の打上げの様子を現地、種子島宇宙センターからライブ配信します。\nThe launch of H3 Rocket F10 will be broadcast live from the Tanegashima Space Center.\n\n打上げ予定日（Launch Date）：　2026.10.20\n打上げ予定時刻（Launch Time）：4:41’03”　+0900 (JST)\n予備期間（Preliminary duration）：2026.10.21～2026.11.7\nペイロード（Payload）：火星衛星探査機（MMX）\n\n打上げ前会見　Pre-Launch Briefing\n　https://www.youtube.com/live/uYfYCWStDGY\n\n機体移動　transfer operation\n　https://www.youtube.com/live/kI8Escaf9-g\n　\n見守る配信　watch over the rocket before launch\n　https://www.youtube.com/live/5NJ9smSXP5s\n\n打上げ　Launch\n　https://www.youtube.com/live/ghSpAe_gx6k\n\n打上げ後会見　Post-Press Conference\n　https://www.youtube.com/live/6ePIiHm2Nm8\n\nNVS配信スケジュール　Our Streaming Schedule\n　http://blog.nvs-live.com/?eid=883\n\nこのチャンネルのメンバーになって特典にアクセスしてください:\nhttps://www.youtube.com/channel/UCDkGOo9VQFjijIDZJidoNmg/join",
      "feature_image": "https://i.ytimg.com/vi/ghSpAe_gx6k/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=ghSpAe_gx6k"
    }
  ],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/h3-24_liftoff__image_20251028184029.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 7417,
  "location_launch_attempt_count": 100,
  "pad_launch_attempt_count": 19,
  "agency_launch_attempt_count": 59,
  "orbital_launch_attempt_count_year": 244,
  "location_launch_attempt_count_year": 3,
  "pad_launch_attempt_count_year": 3,
  "agency_launch_attempt_count_year": 3
}