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/ca78b818-63d5-4280-853e-478db107b022/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "ca78b818-63d5-4280-853e-478db107b022",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/ca78b818-63d5-4280-853e-478db107b022/?format=api",
    "slug": "h-iia-202-igs-radar-8",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "H-IIA 202 | IGS Radar 8",
    "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
    },
    "last_updated": "2024-09-26T07:44:20Z",
    "updates": [
        {
            "id": 8709,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Launch success.",
            "info_url": "https://www.mhi.com/jp/news/24092602.html",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-26T07:44:00Z"
        },
        {
            "id": 8705,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Spacecraft separation.",
            "info_url": "https://x.com/MHI_LS/status/1839179105197240342",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-26T05:46:00Z"
        },
        {
            "id": 8704,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Liftoff.",
            "info_url": "https://www.youtube.com/watch?v=OR233zV8xRo",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-26T05:24:00Z"
        },
        {
            "id": 8703,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Unofficial Webcast by NVS has started",
            "info_url": "https://www.youtube.com/watch?v=OR233zV8xRo",
            "created_by": "LL2",
            "created_on": "2024-09-26T04:20:00Z"
        },
        {
            "id": 8677,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for September 26.",
            "info_url": "https://x.com/mhi_groupjp/status/1838086931676328265",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-23T05:31:00Z"
        },
        {
            "id": 8612,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Multiple days delay expected with rocket rolled back to VAB.",
            "info_url": "https://www.youtube.com/watch?v=uihNk3t4XNA",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-16T01:52:00Z"
        },
        {
            "id": 8611,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Scrubbed for the day due to upper level winds.",
            "info_url": "https://x.com/MHI_LS/status/1835431598831161733",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-16T00:17:00Z"
        },
        {
            "id": 8565,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for September 16.",
            "info_url": "https://www.mhi.com/jp/news/240913.html",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-13T06:12:00Z"
        },
        {
            "id": 8521,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Postponed from September 11 due to launch site weather, new date TBD.",
            "info_url": "https://www.mhi.com/jp/news/240909.html",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-09T05:16:00Z"
        },
        {
            "id": 8086,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "GO for launch.",
            "info_url": "https://x.com/MHI_LS/status/1813094058962919486",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-07-16T06:21:13Z"
        },
        {
            "id": 7257,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET Late Q3 2024.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=1181.msg2584541#msg2584541",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-04-10T13:23:57Z"
        },
        {
            "id": 6223,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Tweaked approximate launch date per launch manifest (P.129 of source).",
            "info_url": "https://www8.cao.go.jp/space/comittee/dai108/siryou2_2.pdf",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-09T14:25:11Z"
        }
    ],
    "net": "2024-09-26T05:24:20Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2024-09-26T05:25:21Z",
    "window_start": "2024-09-26T05:24:20Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "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": 54,
        "consecutive_successful_launches": 6,
        "successful_launches": 53,
        "failed_launches": 1,
        "pending_launches": 13,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.mhi.com/",
        "wiki_url": "http://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": 2999,
        "configuration": {
            "id": 32,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/32/?format=api",
            "name": "H-IIA",
            "active": true,
            "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": 54,
                "consecutive_successful_launches": 6,
                "successful_launches": 53,
                "failed_launches": 1,
                "pending_launches": 13,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.mhi.com/",
                "wiki_url": "http://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": 34,
            "consecutive_successful_launches": 34,
            "successful_launches": 34,
            "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": {
        "id": 5896,
        "name": "IGS Radar 8",
        "description": "The IGS Radar 8 is a Japanese radar reconnaissance satellite. The satellite is operated by the Cabinet Satellite Information Center. The satellite serves both Japan's national defense and civil natural disaster monitoring.",
        "launch_designator": null,
        "type": "Government/Top Secret",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "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": 94,
            "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": 56,
        "orbital_launch_attempt_count": 56
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "NVS",
            "title": "H-IIAロケット49号機 情報収集衛星レーダー8号機 再打上げ H-2A Rocket F49 IGS-Radar 8 Re-Launch Live Streaming",
            "description": "打上げ予定日(Launch Date):2024.09.26\n打上げ予定時刻(Launch Time):14:24'20\" +0900 (JST)\n打上げ可能時間帯(Window):  14:24'20\"~14:25'21\" +0900 (JST)\n予備期間(Preliminary duration): 2024.09.27~2024.10.31\nペイロード衛星(Payload): 情報取集衛星「...",
            "feature_image": "https://i.ytimg.com/vi/OR233zV8xRo/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=OR233zV8xRo",
            "type": {
                "id": 3,
                "name": "Unofficial Webcast"
            },
            "language": {
                "id": 6,
                "name": "Japanese",
                "code": "jp"
            },
            "start_time": "2024-09-26T04:20:35Z",
            "end_time": "2024-09-26T06:06:31Z"
        }
    ],
    "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": 6769,
    "location_launch_attempt_count": 92,
    "pad_launch_attempt_count": 56,
    "agency_launch_attempt_count": 52,
    "orbital_launch_attempt_count_year": 180,
    "location_launch_attempt_count_year": 4,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 4,
    "pad_turnaround": "P258DT39M54S",
    "mission_patches": [],
    "type": "detailed"
}