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/353166c8-e60f-407a-a1fc-67b6455e7d13/?format=api
{ "id": "353166c8-e60f-407a-a1fc-67b6455e7d13", "url": "https://ll.thespacedevs.com/2.2.0/launch/353166c8-e60f-407a-a1fc-67b6455e7d13/?format=api", "slug": "long-march-3b-apstar-2r", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 3B | Apstar 2R", "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-08-04T03:15:37Z", "updates": [], "net": "1997-10-16T19:13:00Z", "net_precision": null, "window_end": "1997-10-16T19:13:00Z", "window_start": "1997-10-16T19:13:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 189, "url": "https://ll.thespacedevs.com/2.2.0/agencies/189/?format=api", "name": "China Aerospace Corporation", "featured": false, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 27, "consecutive_successful_launches": 15, "successful_launches": 24, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 6811, "configuration": { "id": 19, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/19/?format=api", "name": "Long March 3", "active": true, "reusable": false, "description": "The Long March 3B is a Chinese orbital carrier rocket. Introduced in 1996, it is launched from Launch Area 2 and 3 at the Xichang Satellite Launch Center in Sichuan. A three-stage rocket with four strap-on liquid rocket boosters, it is currently the most powerful member of the Long March rocket family and the heaviest of the Long March 3 rocket family, and is mainly used to place communications satellites into geosynchronous orbits.", "family": "Long March", "full_name": "Long March 3B", "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": 523, "consecutive_successful_launches": 65, "successful_launches": 509, "failed_launches": 14, "pending_launches": 9, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://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": "3B", "alias": "", "min_stage": 0, "max_stage": 3, "length": 54.8, "diameter": 3.35, "maiden_flight": "1996-02-14", "launch_cost": "70000000", "launch_mass": 426, "leo_capacity": 11500, "gto_capacity": 5100, "to_thrust": 5923, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20200102181012.jpg", "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/Long_March_3B", "total_launch_count": 24, "consecutive_successful_launches": 3, "successful_launches": 21, "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": 5201, "name": "Apstar 2R", "description": "Space Systems/Loral's (SS/L) Apstar-2R is one of the most powerful spacecraft in Asia-Pacific service. Launched in China in 1997 by APT Satellite Company, Ltd., the satellite offers regional voice, video, and data services to an area large enough to link Europe, Russia, the Middle East, Africa, and the Asia-Pacific region into a broad telecommunications network.", "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": 225, "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": 118, "orbital_launch_attempt_count": 118 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20200102181012.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4182, "location_launch_attempt_count": 25, "pad_launch_attempt_count": 13, "agency_launch_attempt_count": 18, "orbital_launch_attempt_count_year": 64, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P58DT1H23M", "mission_patches": [], "type": "detailed" }
