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/bff2befb-2d26-4b03-97b8-9f7405311517/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "bff2befb-2d26-4b03-97b8-9f7405311517",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/bff2befb-2d26-4b03-97b8-9f7405311517/?format=api",
    "slug": "rokot-briz-km-cryosat",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Rokot / Briz-KM | CRYOSAT",
    "status": {
        "id": 4,
        "name": "Launch Failure",
        "abbrev": "Failure",
        "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate."
    },
    "last_updated": "2023-06-14T03:31:48Z",
    "updates": [],
    "net": "2005-10-08T15:02:00Z",
    "net_precision": null,
    "window_end": "2005-10-08T15:02:00Z",
    "window_start": "2005-10-08T15:02:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 117,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/117/?format=api",
        "name": "Eurockot Launch Services",
        "featured": false,
        "type": "Commercial",
        "country_code": "FRA,RUS",
        "abbrev": "ELS",
        "description": "Eurockot Launch Services GmbH is a commercial spacecraft launch provider and was founded in 1995. Eurockot uses an expendable launch vehicle called the Rockot to place satellites into low Earth orbit (LEO). Eurockot is jointly owned by ArianeGroup, which holds 51 percent, and by Khrunichev State Research and Production Space Center, which holds 49 percent. Eurockot launches from dedicated launch facilities at the Plesetsk Cosmodrome in northern Russia.",
        "administrator": null,
        "founding_year": null,
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 14,
        "consecutive_successful_launches": 8,
        "successful_launches": 13,
        "failed_launches": 1,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.eurockot.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/Eurockot_Launch_Services",
        "logo_url": null,
        "image_url": null,
        "nation_url": null
    },
    "rocket": {
        "id": 7245,
        "configuration": {
            "id": 40,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/40/?format=api",
            "name": "Rokot/Briz-KM",
            "active": true,
            "reusable": false,
            "description": "",
            "family": "Rokot",
            "full_name": "Rokot/Briz-KM",
            "manufacturer": {
                "id": 163,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/163/?format=api",
                "name": "Russian Aerospace Defence Forces",
                "featured": false,
                "type": "Government",
                "country_code": "RUS",
                "abbrev": "VKO",
                "description": null,
                "administrator": null,
                "founding_year": null,
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 22,
                "consecutive_successful_launches": 17,
                "successful_launches": 20,
                "failed_launches": 2,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.eng.mil.ru/en/structure/forces/cosmic.htm",
                "wiki_url": "http://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces",
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "Briz-KM",
            "alias": "",
            "min_stage": 1,
            "max_stage": 3,
            "length": 29.0,
            "diameter": 2.5,
            "maiden_flight": "2000-05-16",
            "launch_cost": null,
            "launch_mass": 107,
            "leo_capacity": 1850,
            "gto_capacity": 0,
            "to_thrust": 1870,
            "apogee": 1500,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rokot25202f2520briz-km_image_20190224012237.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Rokot",
            "total_launch_count": 31,
            "consecutive_successful_launches": 14,
            "successful_launches": 28,
            "failed_launches": 3,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 5634,
        "name": "CRYOSAT",
        "description": "CryoSat-1 was launched from the Plesetsk Cosmodrome in Russia on October 8, 2005, using a Rockot launcher. (Rockot is a modified SS-19 rocket which was originally an ICBM designed to deliver nuclear weapons, but which Russia is now eliminating in accordance with the START treaties.) According to Mr. Yuri Bakhvalov, First Deputy Director General of the Khrunichev Space Centre, when the automatic command to switch off the second stage engine did not take effect, the second stage continued to operate until it ran out of fuel and as a consequence the planned separation of the third (Breeze-KM) stage of the rocket which carried the CryoSat satellite did not take place, and would thus have remained attached to the second stage. The upper rocket stages, together with the satellite, probably crashed in the Lincoln Sea. Analysis of the error revealed that it was caused by faults in the programming of the rocket, which had not been detected in simulations.",
        "launch_designator": null,
        "type": "Planetary Science",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 3,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/3/?format=api",
        "agency_id": 163,
        "name": "133/3 (133L)",
        "description": null,
        "info_url": null,
        "wiki_url": "",
        "map_url": "https://www.google.com/maps?q=62.886999,40.846984",
        "latitude": "62.886999",
        "longitude": "40.846984",
        "location": {
            "id": 6,
            "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api",
            "name": "Plesetsk Cosmodrome, Russian Federation",
            "country_code": "RUS",
            "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg",
            "timezone_name": "Europe/Moscow",
            "total_launch_count": 1674,
            "total_landing_count": 0
        },
        "country_code": "RUS",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_3_20200803143438.jpg",
        "total_launch_count": 159,
        "orbital_launch_attempt_count": 159
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rokot25202f2520briz-km_image_20190224012237.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 4737,
    "location_launch_attempt_count": 1544,
    "pad_launch_attempt_count": 135,
    "agency_launch_attempt_count": 6,
    "orbital_launch_attempt_count_year": 43,
    "location_launch_attempt_count_year": 4,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P42DT20H27M32S",
    "mission_patches": [],
    "type": "detailed"
}