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/87d3fde4-e6f6-4e8b-bc9a-d5c28915acb3/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "87d3fde4-e6f6-4e8b-bc9a-d5c28915acb3",
    "url": "https://lldev.thespacedevs.com/2.0.0/launch/87d3fde4-e6f6-4e8b-bc9a-d5c28915acb3/?format=api",
    "launch_library_id": null,
    "slug": "h-iia-202-gosat-gw-ibuki-gw",
    "name": "H-IIA 202 | GOSAT-GW (Ibuki GW)",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2025-06-28T16:33:03Z",
    "window_end": "2025-06-28T16:52:00Z",
    "window_start": "2025-06-28T16:33:03Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 37,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/37/?format=api",
        "name": "Japan Aerospace Exploration Agency",
        "featured": true,
        "type": "Government",
        "country_code": "JPN",
        "abbrev": "JAXA",
        "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.",
        "administrator": "Administrator: Hiroshi Yamakawa",
        "founding_year": "2003",
        "launchers": "H-II",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 37,
        "consecutive_successful_launches": 2,
        "successful_launches": 33,
        "failed_launches": 4,
        "pending_launches": 3,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.jaxa.jp/",
        "wiki_url": "https://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png"
    },
    "rocket": {
        "id": 156,
        "configuration": {
            "id": 32,
            "launch_library_id": 53,
            "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/32/?format=api",
            "name": "H-IIA",
            "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://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": 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": "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_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
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 5892,
        "launch_library_id": null,
        "name": "GOSAT-GW (Ibuki GW)",
        "description": "GOSAT-GW (Greenhouse Gases Observing Satellite Greenhouse gases and Water cycle), also known as Ibuki GW and formerly known as GOSAT 3, is JAXA's next generation satellite to monitor the greenhosue gases like carbon dioxide in the Earth's atmosphere. It is the follow on to the GOSAT 2 (Ibuki 2) and GCOM-W (Shizuku) missions.\r\n\r\nGOSAT-GW will have two missions: greenhouse gases observation for Japan's Ministry of the Environment and the National Institute for Environmental Studies (NIES), and water-cycle observation for JAXA. By developing the GOSAT-GW satellite, Mitsubishi Electric will contribute to measures for preventing disasters attributed to global warming and climate change, and to advance scientific and technological methods that enable more accurate prediction of climate change.\r\n\r\nIn December 2013, Mitsubishi Electric (MELCO) was selected as the prime contractor for the spacecraft and the instruments.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 41,
        "url": "https://lldev.thespacedevs.com/2.0.0/pad/41/?format=api",
        "agency_id": 37,
        "name": "Yoshinobu Launch Complex LP-1",
        "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://lldev.thespacedevs.com/2.0.0/location/26/?format=api",
            "name": "Tanegashima Space Center, Japan",
            "country_code": "JPN",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg",
            "total_launch_count": 95,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg",
        "total_launch_count": 57
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 10,
            "title": "Launch of “IBUKI GW”(GOSAT-GW) aboard H-IIA Launch Vehicle No.50",
            "description": "The live coverage of the launch of the Global Observing SATellite for Greenhouse gases and Water cycle (GOSAT-GW) aboard the H-IIA Launch Vehicle No. 50 (H-IIA F50).\n日本語 → https://www.youtube.com/live...",
            "feature_image": "https://i.ytimg.com/vi/5tRdzj_7OwQ/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=5tRdzj_7OwQ"
        },
        {
            "priority": 11,
            "title": "温室効果ガス・水循環観測技術衛星(GOSAT-GW)/H-IIAロケット50号機打上げライブ中継",
            "description": "温室効果ガス・水循環観測技術衛星「いぶきGW」(GOSAT-GW)を搭載したH-IIAロケット50号機打上げの様子を、種子島宇宙センターよりライブ配信します。\nEnglish → https://www.youtube.com/live/5tRdzj_7OwQ\n\n配信予定:2025年6月29日00:35頃~\n打上げ時間帯:午前1時33分03秒~午前1時52分00秒(日本標準時)\n場所:種子島宇宙セ...",
            "feature_image": "https://i.ytimg.com/vi/MZopG-xQN1s/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=MZopG-xQN1s"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6994,
    "location_launch_attempt_count": 95,
    "pad_launch_attempt_count": 57,
    "agency_launch_attempt_count": 37,
    "orbital_launch_attempt_count_year": 145,
    "location_launch_attempt_count_year": 2,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1
}