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/7132c569-0eac-46da-a013-73a488d27e1d/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "7132c569-0eac-46da-a013-73a488d27e1d",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/7132c569-0eac-46da-a013-73a488d27e1d/?format=api",
    "slug": "h-iia-202-khalifasat-gosat-2",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "H-IIA 202 | KhalifaSat & GOSAT-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-07-07T12:52:52Z",
    "updates": [],
    "net": "2018-10-29T04:08:00Z",
    "net_precision": null,
    "window_end": "2018-10-29T04:20:00Z",
    "window_start": "2018-10-29T04:08:00Z",
    "probability": -1,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": "#H2AF40",
    "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": 2145,
        "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": 901,
        "name": "KhalifaSat & GOSAT-2",
        "description": "KhalifaSat is an Earth observation satellite for UAE. KhalifaSat will provide high-resolution imagery of Earth to be used for various purposes, including urban planning, change monitoring, area classification, monitoring environmental change and aiding relief efforts for natural disasters. GOSAT 2 (Greenhouse gases Observing SATellite 2) is a Japanese satellite dedicated to greenhouse gas measurement from space. It's a follow on to the GOSAT mission and includes such improvements as an ability to gather more precise data and monitor carbon monoxide concentrations.",
        "launch_designator": null,
        "type": "Earth Science",
        "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": [
        {
            "priority": 0,
            "source": null,
            "title": "MHI Launch Services",
            "description": "Mitsubishi Heavy Industries Space Launch Services Program. Your Cargo. Your Schedule. Precision Delivered.",
            "feature_image": null,
            "url": "https://stories.mhi.group/en/launchservices",
            "type": null,
            "language": null
        }
    ],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "【現地中継】H-2Aロケット40号機 いぶき2号打上げ / H-2A Rocket F40 GOSAT-2 KhalifaSat Launch",
            "description": "10月29日 13:08~13:20頃に予定されている H-2Aロケット40号機打上げの様子を 現地種子島から中継します。 打上げ予定日(Launch Date):2018/10/29 打上げ予定時刻(Launch Time):13:08~13:20 +0900 (JST) 打上げ時間帯(launch windo...",
            "feature_image": "https://i.ytimg.com/vi/Tn0dH6OGJg8/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=Tn0dH6OGJg8",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "H-IIAロケット40号機打上げライブ中継 / Live streaming the launch of H-IIA Rocket No.40",
            "description": "打上げ特設サイトもご覧ください:https://stories.mhi.group/ja/launchservices 10月29日(月)、H-IIAロケット40号機(H-IIA・F40)による温室効果ガス観測技術衛星2号「いぶき2号」(GOSAT-2)及びアラブ首長国連邦(UAE)のドバイ政府宇宙機関であるMB...",
            "feature_image": "https://i.ytimg.com/vi/42lrAkmBNvg/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=42lrAkmBNvg",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "H-IIAロケット40号機(いぶき2号/KhalifaSat)打上げ_種子島宇宙センター",
            "description": "2018.10.29に種子島宇宙センターで「いぶき2号(GOSAT-2)」「ハリーファサット(KhalifaSat)」が打ち上げられました。 撮影場所:南種子町 上里地区",
            "feature_image": "https://i.ytimg.com/vi/tVtQpSkkeA8/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=tVtQpSkkeA8",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "温室効果ガス観測技術衛星「いぶき2号」(GOSAT-2)/ H-IIAロケット40号機打上げライブ中継",
            "description": "10月29日(月)、H-IIAロケット40号機による温室効果ガス観測技術衛星2号「いぶき2号」(GOSAT-2)及びアラブ首長国連邦(UAE)のドバイ政府宇宙機関であるMBRSC(The Mohammed bin Rashid Space Centre)の「観測衛星ハリーファサット(KhalifaSat)」の打上...",
            "feature_image": "https://i.ytimg.com/vi/OAyL0VCf_L4/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=OAyL0VCf_L4",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "KhalifaSat Launch - Live from Tanegashima Space Center, Japan",
            "description": "LIVE: Watch KhalifaSat’s launch live from the Tanegashima Space Center in Japan, aboard the H-IIA rocket from MHI, on 29 October 2018, at 8:08 AM Dubai time ...",
            "feature_image": "https://i.ytimg.com/vi/ragPCDtrNf0/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=ragPCDtrNf0",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "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": 5792,
    "location_launch_attempt_count": 78,
    "pad_launch_attempt_count": 47,
    "agency_launch_attempt_count": 39,
    "orbital_launch_attempt_count_year": 86,
    "location_launch_attempt_count_year": 4,
    "pad_launch_attempt_count_year": 3,
    "agency_launch_attempt_count_year": 3,
    "pad_turnaround": "P138DT23H48M",
    "mission_patches": [],
    "type": "detailed"
}