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/dfca9f78-6ad5-46af-99fb-f2d575dfcb46/?format=api
{ "id": "dfca9f78-6ad5-46af-99fb-f2d575dfcb46", "url": "https://ll.thespacedevs.com/2.2.0/launch/dfca9f78-6ad5-46af-99fb-f2d575dfcb46/?format=api", "slug": "long-march-2c-cfosat", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 2C | CFOSAT", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-06-15T13:58:12Z", "updates": [], "net": "2018-10-29T00:43:14Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2018-10-29T00:43:14Z", "window_start": "2018-10-29T00:43:14Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "#CFOSAT", "launch_service_provider": { "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": 524, "consecutive_successful_launches": 66, "successful_launches": 510, "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" }, "rocket": { "id": 18, "configuration": { "id": 61, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/61/?format=api", "name": "Long March 2", "active": true, "reusable": false, "description": "The Long March 2C is a family of expendable launch vehicles made and operated by China. It is a two stage launch vehicle with storable propellants, consisting of Nitrogen Tetroxide and Unsymmetrical Dimethylhydrazine.", "family": "Long March", "full_name": "Long March 2C", "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": 524, "consecutive_successful_launches": 66, "successful_launches": 510, "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": "C", "alias": "", "min_stage": 2, "max_stage": 2, "length": 42.0, "diameter": 3.35, "maiden_flight": "1982-09-09", "launch_cost": null, "launch_mass": 233, "leo_capacity": 3850, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20230803100234.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_2C", "total_launch_count": 62, "consecutive_successful_launches": 40, "successful_launches": 61, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 657, "name": "CFOSAT", "description": "CFOSAT (China-France Oceanography SATellite) is a joint mission of the Chinese (CNSA) and French (CNES) space agencies with the goal to monitor the ocean surface winds and waves and to provide information on related ocean and atmospheric science and applications. The primary objective of CFOSAT is to monitor on a global scale the wind and waves at the ocean surface.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 22, "url": "https://ll.thespacedevs.com/2.2.0/pad/22/?format=api", "agency_id": null, "name": "Launch Area 4 (SLS-2 / 603)", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4", "map_url": "https://www.google.com/maps?q=40.960482,100.298059", "latitude": "40.960482", "longitude": "100.298059", "location": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 251, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_22_20200803143437.jpg", "total_launch_count": 124, "orbital_launch_attempt_count": 124 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Long March-2C launches CFOSat (China-France Oceanography Satellite)", "description": "A Long March-2C launch vehicle launched CFOSat (China-France Oceanography Satellite) from the Jiuquan Satellite Launch Center, Gansu Province, northwest Chin...", "feature_image": "https://i.ytimg.com/vi/RwPKzp3ScOQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=RwPKzp3ScOQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Lancement du satellite CFOSAT le 29/10/2018", "description": "Lancement du satellite sino-français CFOSAT à bord d'une fusée Longue Marche 2C le 29 octobre 2018 à 0h47 UTC. Crédits : CNSA. https://cfosat.cnes.fr", "feature_image": "https://i.ytimg.com/vi/laxCNs_87Z8/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=laxCNs_87Z8", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "YouTube", "description": "If the owner of this video has granted you access, please sign in.", "feature_image": null, "url": "https://www.youtube.com/watch?v=D7xXiEldgCc", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20230803100234.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5791, "location_launch_attempt_count": 109, "pad_launch_attempt_count": 59, "agency_launch_attempt_count": 236, "orbital_launch_attempt_count_year": 85, "location_launch_attempt_count_year": 12, "pad_launch_attempt_count_year": 8, "agency_launch_attempt_count_year": 29, "pad_turnaround": "P19DT22H11S", "mission_patches": [], "type": "detailed" }
