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/7409ce63-4f65-44d6-804c-5784189bf7b5/?format=api
{ "id": "7409ce63-4f65-44d6-804c-5784189bf7b5", "url": "https://ll.thespacedevs.com/2.2.0/launch/7409ce63-4f65-44d6-804c-5784189bf7b5/?format=api", "slug": "soyuz-stafregat-cso-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz STA/Fregat | CSO-2", "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-06-14T04:08:36Z", "updates": [ { "id": 170, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launched called success on webcast, Arianespace CEO and head of Roscosmos both tweeted that sat is in planned orbit", "info_url": "https://twitter.com/arianespaceceo/status/1343978598437441540", "created_by": "spacevogel", "created_on": "2020-12-29T18:03:35Z" }, { "id": 169, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Liftoff", "info_url": null, "created_by": "spacevogel", "created_on": "2020-12-29T16:42:40Z" }, { "id": 168, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "", "info_url": "https://twitter.com/Arianespace/status/1343542519213285376", "created_by": "Nosu", "created_on": "2020-12-28T13:04:25Z" }, { "id": 167, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "", "info_url": "https://twitter.com/RussianSpaceWeb/status/1343523318675210241?s=20", "created_by": "Nosu", "created_on": "2020-12-28T11:55:00Z" }, { "id": 164, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "", "info_url": "https://www.arianespace.com/press-release/arianespace-will-orbit-cso-2-satellite-for-cnes-and-dga-on-behalf-of-the-french-ministry-of-defense-flight-vs25/", "created_by": "spacevogel", "created_on": "2020-12-22T21:13:49Z" }, { "id": 100, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "per NOTAM A0474/20", "info_url": null, "created_by": "Nosu", "created_on": "2020-12-08T13:33:35Z" } ], "net": "2020-12-29T16:42:07Z", "net_precision": null, "window_end": "2020-12-29T16:42:07Z", "window_start": "2020-12-29T16:42:07Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 321, "consecutive_successful_launches": 9, "successful_launches": 306, "failed_launches": 15, "pending_launches": 38, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.arianespace.com", "wiki_url": "https://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 2191, "configuration": { "id": 49, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/49/?format=api", "name": "Soyuz STA", "active": true, "reusable": false, "description": "The 2.1a version includes conversion from analog to digital flight control system and uprated engines on the booster and the first stage with improved injection systems. The new digital flight control and telemetry systems allow the rocket to launch from a fixed rather than angled launch platform and adjust its heading in flight. A digital control system also enables the launch of larger commercial satellites with wider and longer payload fairings such as the ST-type fairing. These fairings introduce too much aerodynamic instability for the old analog system to handle. This stage continues to use the RD-0110 engine.\r\n\r\nThe 2.1a/ST version is sometimes called Soyuz ST-A.", "family": "Soyuz", "full_name": "Soyuz STA Fregat", "manufacturer": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/agencies/111/?format=api", "name": "Progress Rocket Space Center", "featured": false, "type": "Commercial", "country_code": "RUS", "abbrev": "PRSC", "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.", "administrator": "CEO: Dmitry Baranov", "founding_year": "1996", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 45, "consecutive_successful_launches": 3, "successful_launches": 44, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://en.samspace.ru/", "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "Fregat", "alias": "", "min_stage": 3, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2011-12-17", "launch_cost": null, "launch_mass": 312, "leo_capacity": 7020, "gto_capacity": 2810, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 8, "consecutive_successful_launches": 8, "successful_launches": 8, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 954, "name": "CSO-2", "description": "The CSO-2 (Composante Spatiale Optique-2) satellite is the second of three new-generation high-resolution optical imaging satellites for the French military, replacing the Helios 2 spy satellite series.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 81, "url": "https://ll.thespacedevs.com/2.2.0/pad/81/?format=api", "agency_id": 115, "name": "Soyuz Launch Complex", "description": "The Ensemble de Lancement Soyouz (ELS) is a launch complex at the Guiana Space Centre in Kourou/Sinnamary, French Guiana. It was used by Soyuz-ST rockets: modified versions of the Soyuz-2 optimised for launch from Kourou under Soyuz at the Guiana Space Centre programme.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ensemble_de_Lancement_Soyouz", "map_url": "https://www.google.com/maps?q=5.3019,-52.8346", "latitude": "5.3019", "longitude": "-52.8346", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 327, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_81_20200803143601.jpg", "total_launch_count": 26, "orbital_launch_attempt_count": 26 }, "infoURLs": [ { "priority": 10, "source": null, "title": "Soyuz Flight VS25", "description": "For its 10th and final launch of the year — and the fifth in 2020 with the Soyuz medium launcher — Arianespace will send the CSO-2 Earth observation satellite, intended for defense and security applications, into Sun-synchronous orbit.\n\nCSO-2 will be launched for the French CNES (Centre National d’E...", "feature_image": null, "url": "https://www.arianespace.com/mission/soyuz-flight-vs25/", "type": null, "language": null } ], "vidURLs": [ { "priority": 9, "source": null, "publisher": null, "title": "Décollage Soyouz VS25 - 29/12/2020", "description": "Le 29 décembre, Soyouz décollait pour la 25e fois du Centre spatial guyanais avec le satellite français CSO-2 à son bord.", "feature_image": "https://i.ytimg.com/vi/molMEKLwYaw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=molMEKLwYaw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Arianespace Flight VS25 - CSO-2 (EN)", "description": "For its 10th and final launch of the year — and the fifth in 2020 with the Soyuz medium launcher — Arianespace will send the CSO-2 Earth observation satellit...", "feature_image": "https://i.ytimg.com/vi/p74FqD_HlOE/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=p74FqD_HlOE", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6037, "location_launch_attempt_count": 304, "pad_launch_attempt_count": 24, "agency_launch_attempt_count": 292, "orbital_launch_attempt_count_year": 115, "location_launch_attempt_count_year": 7, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 10, "pad_turnaround": "P27DT15H8M39S", "mission_patches": [], "type": "detailed" }
