Launch Instance
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/d1d6a521-65f5-44df-93ba-5f79773186f4/?format=api
{ "id": "d1d6a521-65f5-44df-93ba-5f79773186f4", "url": "https://ll.thespacedevs.com/2.2.0/launch/d1d6a521-65f5-44df-93ba-5f79773186f4/?format=api", "slug": "atlas-agena-a-samos-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas Agena A | Samos 1", "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-14T04:18:00Z", "updates": [], "net": "1960-10-11T20:33:28Z", "net_precision": null, "window_end": "1960-10-11T20:33:28Z", "window_start": "1960-10-11T20:33:28Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USAF", "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": "1947", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.af.mil", "wiki_url": "http://en.wikipedia.org/wiki/United_States_Air_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg" }, "rocket": { "id": 3084, "configuration": { "id": 231, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/231/?format=api", "name": "Atlas Agena A", "active": false, "reusable": false, "description": "The Atlas-Agena was an American expendable launch system derived from the SM-65 Atlas missile. It was a member of the Atlas family of rockets, and was launched 109 times between 1960 and 1978.", "family": "Atlas", "full_name": "Atlas LV-3 Agena A", "manufacturer": { "id": 1004, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1004/?format=api", "name": "Convair", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": "1943", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "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/Convair", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "Agena A", "alias": "", "min_stage": 2, "max_stage": 2, "length": 36.0, "diameter": 3.0, "maiden_flight": "1960-02-26", "launch_cost": null, "launch_mass": 155, "leo_capacity": 1000, "gto_capacity": null, "to_thrust": 1340, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Atlas-Agena", "total_launch_count": 3, "consecutive_successful_launches": 0, "successful_launches": 1, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1506, "name": "Samos 1", "description": "A Satellite and Missile Observation satallite which failed to enter orbit due to a failure in the launch vehicle guidance system", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 93, "url": "https://ll.thespacedevs.com/2.2.0/pad/93/?format=api", "agency_id": 161, "name": "Space Launch Complex 3W", "description": "SLC-3W was originally built for Atlas-Agena launches and the first flight off the pad was the launch of Samos 1 on October 11, 1960. The facility was extensively damaged 11 months later when Samos 3's booster exploded on the pad, but it was repaired quickly and hosted its next launch slightly under two months afterwards.\r\n\r\nIn 1962-63, the pad was converted for Thor-Agena use and was the primary launching site for Corona reconnaissance satellites for the next decade. After the Corona program ended in 1972, SLC-3W was converted back to support Atlases, this time flights of refurbished Atlas E/F missiles. The final such launch took place in 1995.\r\n\r\nSpaceX initially planned to use SLC-3W for the Falcon 1 launch vehicle but switched to SLC-4E with Falcon 9.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_3#SLC-3W", "map_url": "https://www.google.com/maps?q=34.644,-120.593", "latitude": "34.644", "longitude": "-120.593", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 804, "total_landing_count": 26 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_93_20200803143225.jpg", "total_launch_count": 81, "orbital_launch_attempt_count": 81 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 81, "location_launch_attempt_count": 16, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 31, "orbital_launch_attempt_count_year": 27, "location_launch_attempt_count_year": 8, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 20, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
