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/01e8127b-aac8-47ec-85fa-77f75aa4c4d2/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "01e8127b-aac8-47ec-85fa-77f75aa4c4d2",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/01e8127b-aac8-47ec-85fa-77f75aa4c4d2/?format=api",
    "slug": "n-2-yuri-2b",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "N-2 | Yuri 2B",
    "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-07T13:08:27Z",
    "updates": [],
    "net": "1986-02-12T07:55:00Z",
    "net_precision": null,
    "window_end": "1986-02-12T07:55:00Z",
    "window_start": "1986-02-12T07:55:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 228,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/228/?format=api",
        "name": "National Space Development Agency of Japan",
        "featured": false,
        "type": "Government",
        "country_code": "JPN",
        "abbrev": "NASDA",
        "description": null,
        "administrator": null,
        "founding_year": null,
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 15,
        "consecutive_successful_launches": 10,
        "successful_launches": 14,
        "failed_launches": 1,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/National_Space_Development_Agency_of_Japan",
        "logo_url": null,
        "image_url": null,
        "nation_url": null
    },
    "rocket": {
        "id": 5836,
        "configuration": {
            "id": 341,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/341/?format=api",
            "name": "N-2",
            "active": false,
            "reusable": false,
            "description": "The N-II or N-2 was a derivative of the American Delta rocket, produced under licence in Japan. It replaced the N-I-rocket in Japanese use. It used a Thor-ELT first stage, a Delta-F second stage, nine Castor SRMs, and on most flights either a Star-37E or Burner-2 upper stage, identical to the US Delta 0100 series configurations. Eight were launched between 1981 and 1987, before it was replaced by the H-I, which featured Japanese-produced upper stages. All eight launches were successful.",
            "family": "",
            "full_name": "N-2",
            "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": "2",
            "alias": "",
            "min_stage": 2,
            "max_stage": 3,
            "length": 35.0,
            "diameter": 2.44,
            "maiden_flight": "1981-02-11",
            "launch_cost": null,
            "launch_mass": 132,
            "leo_capacity": 2000,
            "gto_capacity": 730,
            "to_thrust": 2278,
            "apogee": null,
            "vehicle_range": null,
            "image_url": null,
            "info_url": "",
            "wiki_url": "https://en.wikipedia.org/wiki/N-II_(rocket)",
            "total_launch_count": 8,
            "consecutive_successful_launches": 8,
            "successful_launches": 8,
            "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": 4234,
        "name": "Yuri 2B",
        "description": "First generation Japanese direct broadcasting satellite",
        "launch_designator": null,
        "type": "Communications",
        "orbit": {
            "id": 1,
            "name": "Geostationary Orbit",
            "abbrev": "Direct-GEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 10,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/10/?format=api",
        "agency_id": 37,
        "name": "Osaki Launch Complex",
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Tanegashima_Space_Center",
        "map_url": "https://www.google.com/maps?q=30.3993934,130.9702486",
        "latitude": "30.3993934",
        "longitude": "130.9702486",
        "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_10_20200803143519.jpg",
        "total_launch_count": 24,
        "orbital_launch_attempt_count": 24
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": null,
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 3046,
    "location_launch_attempt_count": 14,
    "pad_launch_attempt_count": 14,
    "agency_launch_attempt_count": 14,
    "orbital_launch_attempt_count_year": 17,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P558DT11H25M",
    "mission_patches": [],
    "type": "detailed"
}