Launch Library 2

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/d68320e6-6584-4d0b-8da0-71e978d5b8cf/?format=api

HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "d68320e6-6584-4d0b-8da0-71e978d5b8cf",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/d68320e6-6584-4d0b-8da0-71e978d5b8cf/?format=api",
  "slug": "h-iia-202-michibiki-2-qzs-2",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "H-IIA 202 | Michibiki 2 (QZS-2)",
  "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-14T03:53:07Z",
  "updates": [],
  "net": "2017-06-01T00:17:46Z",
  "net_precision": null,
  "window_end": "2017-06-01T00:17:46Z",
  "window_start": "2017-06-01T00:17:46Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": null,
  "hashtag": null,
  "launch_service_provider": {
    "id": 98,
    "url": "https://ll.thespacedevs.com/2.2.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": 57,
    "consecutive_successful_launches": 1,
    "successful_launches": 55,
    "failed_launches": 2,
    "pending_launches": 8,
    "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-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg",
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg"
  },
  "rocket": {
    "id": 2004,
    "configuration": {
      "id": 32,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/32/?format=api",
      "name": "H-IIA",
      "active": false,
      "reusable": false,
      "description": "H-IIA (H2A) is an active expendable launch system operated by Mitsubishi Heavy Industries (MHI) for the Japan Aerospace Exploration Agency. The liquid-fueled H-IIA rockets have been used to launch satellites into geostationary orbit, to launch a lunar orbiting spacecraft, and to launch Akatsuki, which studied the planet Venus. Launches occur at the Tanegashima Space Center.",
      "family": "H-II",
      "full_name": "H-IIA 202",
      "manufacturer": {
        "id": 98,
        "url": "https://ll.thespacedevs.com/2.2.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": 57,
        "consecutive_successful_launches": 1,
        "successful_launches": 55,
        "failed_launches": 2,
        "pending_launches": 8,
        "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-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg"
      },
      "program": [],
      "variant": "202",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 53.0,
      "diameter": 4.0,
      "maiden_flight": "2001-08-29",
      "launch_cost": "90000000",
      "launch_mass": 285,
      "leo_capacity": 10000,
      "gto_capacity": 4100,
      "to_thrust": 2260,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/H-IIA",
      "total_launch_count": 35,
      "consecutive_successful_launches": 35,
      "successful_launches": 35,
      "failed_launches": 0,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 614,
    "name": "Michibiki 2 (QZS-2)",
    "description": "The Quasi-Zenith Satellite System (QZSS) is a three-satellite regional time transfer system and the satellite-based augmentation system for the GPS that would be receivable within Japan. The primary purpose of QZSS is to increase the availability of GPS in Japan's numerous urban canyons, where only satellites at very high elevation can be seen. A secondary function is performance enhancement, increasing the accuracy and reliability of GPS derived navigation solutions. A single satellite weighs about 4000 kg, has an expected lifetime of 15 years and is put in a elliptical, highly inclined geosynchronous orbit.",
    "launch_designator": null,
    "type": "Navigation",
    "orbit": {
      "id": 4,
      "name": "Geosynchronous Transfer Orbit",
      "abbrev": "GSTO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 41,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/41/?format=api",
    "agency_id": 37,
    "name": "Yoshinobu Launch Complex LP-1",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex",
    "map_url": "https://www.google.com/maps?q=30.400813,130.977748",
    "latitude": "30.400813",
    "longitude": "130.977748",
    "location": {
      "id": 26,
      "url": "https://ll.thespacedevs.com/2.2.0/location/26/?format=api",
      "name": "Tanegashima Space Center, Japan",
      "country_code": "JPN",
      "description": "The Tanegashima Space Center is the largest rocket-launch complex in Japan. It is located on the southeastern tip of Tanegashima, an island located south of Kyushu, an island and region and Japan. It was established in 1969 when the National Space Development Agency of Japan (NASDA) was formed, and is now run by JAXA. The activities that take place at TNSC include assembly, testing, launching, and tracking satellites, as well as rocket engine firing tests.",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg",
      "timezone_name": "Asia/Tokyo",
      "total_launch_count": 98,
      "total_landing_count": 0
    },
    "country_code": "JPN",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg",
    "total_launch_count": 57,
    "orbital_launch_attempt_count": 57
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "JAXA | 宇宙航空研究開発機構",
      "title": "みちびき２号機打ち上げライブ中継",
      "description": "H-IIAロケット34号機による「みちびき2号機」打ち上げの様子をライブ中継した録画です。\n\n打ち上げ時刻：9時17分46秒\n放送時間：約35分\n\n\n＊時刻はいずれも予定です。\n＊番組は、打ち上げ準備の状況などにより、延期・時刻変更・休止、延伸・短縮する場合があります。その場合の代替番組はございません。\n＊授業など学校教育の場で配信をご観覧いただくことは、特に事前連絡の必要や制限がございません。\n...",
      "feature_image": "https://i.ytimg.com/vi/5ptjEpjErv8/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=5ptjEpjErv8",
      "type": {
        "id": 1,
        "name": "Official Webcast"
      },
      "language": {
        "id": 6,
        "name": "Japanese",
        "code": "jp"
      },
      "start_time": "2017-05-31T23:44:49Z",
      "end_time": "2017-06-01T00:23:47Z"
    },
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "NVS",
      "title": "H-IIAロケット34号機打上げ（現地中継）",
      "description": "H-IIAロケット34号機による準天頂衛星 みちびき２号機の打上げを現地種子島より中継します。\n\n打上げ予定：2017/06/1(Thu)　 9時20分頃\n打上げ時間帯：\n予備期間：2017/6/2（fri）～6/30（fri）\nペイロード（衛星）：準天頂衛星みちびき2号\n\n最新情報や配信スケジュールの変更等は\nNVSのホームページ　http://nvs-live.com\nツイッター　http:/...",
      "feature_image": "https://i.ytimg.com/vi/Uy5t3dfTCUk/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=Uy5t3dfTCUk",
      "type": {
        "id": 3,
        "name": "Unofficial Webcast"
      },
      "language": {
        "id": 6,
        "name": "Japanese",
        "code": "jp"
      },
      "start_time": "2017-05-31T23:37:06Z",
      "end_time": "2017-06-01T00:47:02Z"
    }
  ],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 5645,
  "location_launch_attempt_count": 71,
  "pad_launch_attempt_count": 41,
  "agency_launch_attempt_count": 33,
  "orbital_launch_attempt_count_year": 30,
  "location_launch_attempt_count_year": 3,
  "pad_launch_attempt_count_year": 3,
  "agency_launch_attempt_count_year": 3,
  "pad_turnaround": "P75DT22H57M46S",
  "mission_patches": [],
  "type": "detailed"
}

Launch Instance