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/d91432d6-fe60-4786-86f3-3dfae0d7a898/?format=api
{ "id": "d91432d6-fe60-4786-86f3-3dfae0d7a898", "url": "https://ll.thespacedevs.com/2.2.0/launch/d91432d6-fe60-4786-86f3-3dfae0d7a898/?format=api", "slug": "soyuz-stbfregat-oneweb-13", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz STB/Fregat | OneWeb 13", "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-03-05T17:58:06Z", "updates": [ { "id": 1278, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Successful satellite deployments were confirmed, launch success is declared.", "info_url": "https://twitter.com/arianespaceceo/status/1491891240488558592", "created_by": "SwGustav", "created_on": "2022-02-10T21:54:39Z" }, { "id": 1275, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Liftoff of Soyuz, carrying a batch of 34 Oneweb satellites to orbit.", "info_url": null, "created_by": "Jay", "created_on": "2022-02-10T18:10:11Z" }, { "id": 1200, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding T-0 per CSG", "info_url": "https://cnes-csg.reservationlancement.fr/en/Inscription/Lancements", "created_by": "Nosu", "created_on": "2022-01-24T19:23:14Z" }, { "id": 1125, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "NET Febuary", "info_url": "https://www.roscosmos.ru/33728/", "created_by": "Jay", "created_on": "2021-12-28T22:13:58Z" }, { "id": 459, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://ria.ru/20210420/raketa-1729024386.html", "created_by": "Nosu", "created_on": "2021-04-21T10:09:11Z" } ], "net": "2022-02-10T18:09:37Z", "net_precision": null, "window_end": "2022-02-10T18:09:37Z", "window_start": "2022-02-10T18:09:37Z", "probability": null, "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": 325, "consecutive_successful_launches": 13, "successful_launches": 310, "failed_launches": 15, "pending_launches": 30, "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_64_lifto_image_20260213070745.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 2858, "configuration": { "id": 171, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/171/?format=api", "name": "Soyuz STB", "active": true, "reusable": false, "description": "The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage. First launch took place from Plesetsk Cosmodrome Site 43 on 26 July 2008 with a classified military payload.\r\n\r\nThe 2.1b/ST version is sometimes called Soyuz ST-B.", "family": "Soyuz", "full_name": "Soyuz STB 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": "STB/Fregat", "alias": "", "min_stage": 3, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2011-10-21", "launch_cost": null, "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_stb_image_20211130181029.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 14, "consecutive_successful_launches": 11, "successful_launches": 13, "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": 1272, "name": "OneWeb 13", "description": "A batch of 34 satellites for the OneWeb satellite constellation, which is intended to provide global Internet broadband service for individual consumers. The constellation is planned to have around 648 microsatellites (of which 60 are spares), around 150 kg each, operating in Ku-band from low Earth orbit.", "launch_designator": null, "type": "Communications", "orbit": { "id": 13, "name": "Polar Orbit", "abbrev": "PO" }, "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": 331, "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": [], "vidURLs": [ { "priority": 0, "source": "youtube.com", "publisher": "The Space Devs", "title": "Soyuz OneWeb 13", "description": "Soyuz OneWeb 13 with initial coverage and post coverage cut\nThumbnail Photo Credit: OneWeb / Roscosmos", "feature_image": "https://i.ytimg.com/vi/XY5Zy9kcNsc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=XY5Zy9kcNsc", "type": { "id": 4, "name": "Unofficial Re-stream" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2022-02-27T01:54:51Z", "end_time": "2022-02-27T02:16:04Z" }, { "priority": 10, "source": "youtube.com", "publisher": "arianespace", "title": "Flight VS27 – OneWeb | Soyuz Launch | Arianespace", "description": "Today’s launch, Flight VS27, was the first Arianespace’s mission of 2022 and the 340th launch overall for the Arianespace family of launchers Ariane, Soyuz and Vega. Performed on Thursday, February 10...", "feature_image": "https://i.ytimg.com/vi/f7AsH_48POE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=f7AsH_48POE", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2022-02-10T17:32:12Z", "end_time": "2022-02-10T21:49:17Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20210520085936.jpeg", "infographic": null, "program": [ { "id": 26, "url": "https://ll.thespacedevs.com/2.2.0/program/26/?format=api", "name": "OneWeb", "description": "Satellite constellation in low Earth orbit that can provide high-speed broadband internet to rural and isolated areas.", "agencies": [ { "id": 1081, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1081/?format=api", "name": "Eutelsat OneWeb", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/oneweb_program_20231228155842.jpeg", "start_date": "2019-02-27T21:37:00Z", "end_date": null, "info_url": "https://oneweb.net/", "wiki_url": "https://en.wikipedia.org/wiki/Eutelsat_OneWeb", "mission_patches": [], "type": { "id": 3, "name": "Communication Constellation" } } ], "orbital_launch_attempt_count": 6194, "location_launch_attempt_count": 312, "pad_launch_attempt_count": 26, "agency_launch_attempt_count": 308, "orbital_launch_attempt_count_year": 12, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P67DT17H50M17S", "mission_patches": [ { "id": 613, "name": "Oneweb 13 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/oneweb2520132_mission_patch_20220203203240.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
