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/b4cb5f4f-247d-4a14-918a-a2e56f46289e/?format=api
{ "id": "b4cb5f4f-247d-4a14-918a-a2e56f46289e", "url": "https://ll.thespacedevs.com/2.2.0/launch/b4cb5f4f-247d-4a14-918a-a2e56f46289e/?format=api", "slug": "soyuz-21bfregat-m-oneweb-12", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b/Fregat-M | OneWeb 12", "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:50:00Z", "updates": [ { "id": 1119, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Success confirmed", "info_url": "https://twitter.com/Arianespace/status/1475526754781564934", "created_by": "SwGustav", "created_on": "2021-12-27T19:13:15Z" }, { "id": 1058, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch date & time confirmed by ROSCOSMOS", "info_url": "https://www.roscosmos.ru/launch/2021/", "created_by": "Nosu", "created_on": "2021-12-09T12:44:13Z" } ], "net": "2021-12-27T13:10:37Z", "net_precision": null, "window_end": "2021-12-27T13:10:37Z", "window_start": "2021-12-27T13:10: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": 323, "consecutive_successful_launches": 11, "successful_launches": 308, "failed_launches": 15, "pending_launches": 34, "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": 2859, "configuration": { "id": 134, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/134/?format=api", "name": "Soyuz 2.1b/Fregat-M", "active": true, "reusable": false, "description": "Soyuz-2, GRAU index 14A14, is the collective designation for the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit. The first-stage boosters and two core stages feature uprated engines with improved injection systems, compared to the previous versions of the Soyuz. Digital flight control and telemetry systems allow the rocket to be launched from a fixed launch platform, whereas the launch platforms for earlier Soyuz rockets had to be rotated as the rocket could not perform a roll to change its heading in flight.", "family": "Soyuz", "full_name": "Soyuz 2.1b Fregat-M", "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-M", "alias": "", "min_stage": 4, "max_stage": 4, "length": 46.3, "diameter": 10.3, "maiden_flight": "2008-07-26", "launch_cost": "48500000", "launch_mass": 313, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": 4150, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2", "total_launch_count": 33, "consecutive_successful_launches": 33, "successful_launches": 33, "failed_launches": 0, "pending_launches": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1273, "name": "OneWeb 12", "description": "A batch of 36 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": 20, "url": "https://ll.thespacedevs.com/2.2.0/pad/20/?format=api", "agency_id": null, "name": "31/6", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31", "map_url": "https://www.google.com/maps?q=45.996034,63.564003", "latitude": "45.996034", "longitude": "63.564003", "location": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1559, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_20_20200803143516.jpg", "total_launch_count": 426, "orbital_launch_attempt_count": 426 }, "infoURLs": [], "vidURLs": [ { "priority": 8, "source": "youtube.com", "publisher": "The Space Devs", "title": "Soyuz OneWeb 12", "description": "Soyuz OneWeb 12 with initial coverage and post coverage cut\nThumbnail Photo Credit: OneWeb / Roscosmos", "feature_image": "https://i.ytimg.com/vi/QbPbeL3XeBA/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=QbPbeL3XeBA", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2022-01-08T21:52:22Z", "end_time": "2022-01-08T21:58:38Z" }, { "priority": 9, "source": "youtube.com", "publisher": "arianespace", "title": "Flight ST37 – OneWeb | Soyuz Launch | Arianespace", "description": "On Monday, December 27, at precisely 06:10 p.m. local time at Russia’s Baikonur Cosmodrome (01:10 p.m. UTC), Soyuz flight ST37 lifted-off with 36 OneWeb satellites bringing, after this successful depl...", "feature_image": "https://i.ytimg.com/vi/Mh16-dAgfAE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Mh16-dAgfAE", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2021-12-27T12:50:23Z", "end_time": "2021-12-27T13:29:48Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Роскосмос ТВ", "title": "Техническая трансляция запуска космических аппаратов OneWeb с космодрома Байконур", "description": "27 декабря 2021 года в 16:10 по московскому времени выполнен пуск ракеты-носителя «Союз-2.1б». \n\nРазгонный блок «Фрегат» доставит 36 аппаратов OneWeb на высоту 450 км, после чего спутники выводятся са...", "feature_image": "https://i.ytimg.com/vi/SwpoeC8BbdU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=SwpoeC8BbdU", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 3, "name": "Russian", "code": "ru" }, "start_time": "2021-12-27T11:30:07Z", "end_time": "2021-12-27T13:21:42Z" } ], "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": 6178, "location_launch_attempt_count": 1529, "pad_launch_attempt_count": 399, "agency_launch_attempt_count": 307, "orbital_launch_attempt_count_year": 141, "location_launch_attempt_count_year": 14, "pad_launch_attempt_count_year": 12, "agency_launch_attempt_count_year": 15, "pad_turnaround": "P19DT5H32M22S", "mission_patches": [ { "id": 598, "name": "OneWeb 12", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/oneweb252012_mission_patch_20211218143400.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
