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/3893b5d0-1f7b-45e4-a91b-66ebe84c93cf/?format=api
{ "id": "3893b5d0-1f7b-45e4-a91b-66ebe84c93cf", "url": "https://ll.thespacedevs.com/2.2.0/launch/3893b5d0-1f7b-45e4-a91b-66ebe84c93cf/?format=api", "slug": "long-march-2e-optus-b2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 2E | Optus B2", "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-08-04T03:07:00Z", "updates": [], "net": "1992-12-21T11:21:00Z", "net_precision": null, "window_end": "1992-12-21T11:21:00Z", "window_start": "1992-12-21T11:21:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Structural failure of payload fairing or satellite 48 seconds after launch destroyed the satellite. \r\n\r\nThe launcher continued its flight to low earth orbit, where it successfully jettisoned the debris. The cause of the failure has never been identified with certainty.", "hashtag": null, "launch_service_provider": { "id": 1037, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1037/?format=api", "name": "Ministry of Aerospace Industry", "featured": false, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "Chinese governmental entity in charge of space research from July 1988 to June 1993.", "administrator": null, "founding_year": "1988", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 13, "consecutive_successful_launches": 0, "successful_launches": 11, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": null, "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 6492, "configuration": { "id": 268, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/268/?format=api", "name": "Long March 2E", "active": false, "reusable": false, "description": "The Long March 2E is a斯expendable launch vehicle made and operated by China. It is a two stage launch vehicle with storable propellants, consisting of Nitrogen Tetroxide and Unsymmetrical Dimethylhydrazine, augmented by 4 liquid fuel boosters using the same fuel.", "family": "Long March", "full_name": "Long March 2E", "manufacturer": { "id": 88, "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": "1999", "launchers": "Long March", "spacecraft": "", "launch_library_url": null, "total_launch_count": 550, "consecutive_successful_launches": 92, "successful_launches": 536, "failed_launches": 14, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "2E", "alias": "", "min_stage": 3, "max_stage": 3, "length": 49.686, "diameter": 7.85, "maiden_flight": "1990-07-16", "launch_cost": null, "launch_mass": 462, "leo_capacity": 9200, "gto_capacity": null, "to_thrust": 5923, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_2", "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 5, "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": 4882, "name": "Optus B2", "description": "Australian communications satellite built by Hughes Space and Communications Company in California.", "launch_designator": null, "type": "Communications", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 45, "url": "https://ll.thespacedevs.com/2.2.0/pad/45/?format=api", "agency_id": null, "name": "Launch Complex 2 (LC-2)", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.245564,102.026751", "latitude": "28.245564", "longitude": "102.026751", "location": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/location/16/?format=api", "name": "Xichang Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "The Xichang Satellite Launch Center is a spaceport in China. It is located in Zeyuan Town, northwest of Xichang, Liangshan Yi Autonomous Prefecture in Sichuan.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_16_20200803142513.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 233, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_45_20200803143520.jpg", "total_launch_count": 121, "orbital_launch_attempt_count": 121 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 3780, "location_launch_attempt_count": 11, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 92, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P129DT12H21M", "mission_patches": [], "type": "detailed" }
