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/79477a4a-055d-460a-9bdc-b3b58a8ac3ca/?format=api
{ "id": "79477a4a-055d-460a-9bdc-b3b58a8ac3ca", "url": "https://ll.thespacedevs.com/2.2.0/launch/79477a4a-055d-460a-9bdc-b3b58a8ac3ca/?format=api", "slug": "soyuz-21bfregat-m-oneweb-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b/Fregat-M | OneWeb 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": "2024-10-13T18:03:11Z", "updates": [], "net": "2020-02-06T21:42:41Z", "net_precision": null, "window_end": "2020-02-06T21:42:41Z", "window_start": "2020-02-06T21:42:41Z", "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": 319, "consecutive_successful_launches": 7, "successful_launches": 304, "failed_launches": 15, "pending_launches": 48, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.arianespace.com", "wiki_url": "http://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": 2599, "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": 31, "consecutive_successful_launches": 31, "successful_launches": 31, "failed_launches": 0, "pending_launches": 4, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1080, "name": "OneWeb 2", "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. Eventually it can be expanded to include extra 1260 satellites, for a total of 1908.", "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": 1555, "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": 422, "orbital_launch_attempt_count": 422 }, "infoURLs": [ { "priority": 0, "source": "www.arianespace.com", "title": "Arianespace launch solutions for all missions and orbits", "description": "Discover the flexible, versatile and modular launch solutions delivered by Arianespace, offering optimized precision and performance for all missions and orbits.", "feature_image": null, "url": "https://www.arianespace.com/mission/soyuz-flight-st27/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "OneWeb Launch #2: Livestream", "description": "OneWeb, the global communications company with a mission to bring connectivity to everyone everywhere, hosts a YouTube livestream of it's launch of 34 satell...", "feature_image": "https://i.ytimg.com/vi/jfWcCeMUFuU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=jfWcCeMUFuU", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Пуск РН «Союз-2.1б» с РБ «Фрегат» и 34 КА OneWeb", "description": "7 февраля 2020 года в 00:42:41 мск с площадки № 31 космодрома Байконур запланирован пуск ракеты-носителя «Союз-2.1б» с разгонным блоком «Фрегат» и 34 космиче...", "feature_image": "https://i.ytimg.com/vi/Ypm37-PYGyY/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Ypm37-PYGyY", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Arianespace Flight ST27 – OneWeb (EN)", "description": "Pour le live en Français: https://www.youtube.com/watch?v=Voijq3WxbqQ For its second mission of the year — and the initial flight in 2020 with the Soyuz medi...", "feature_image": "https://i.ytimg.com/vi/y13iQJ8m1Ms/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=y13iQJ8m1Ms", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20210520085936.jpeg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/soyuz25202.1b_infographic_20200807035203.png", "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": 5930, "location_launch_attempt_count": 1509, "pad_launch_attempt_count": 382, "agency_launch_attempt_count": 284, "orbital_launch_attempt_count_year": 8, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P62DT12H8M30S", "mission_patches": [ { "id": 157, "name": "OneWeb 2 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/oneweb2520225_mission_patch_20211031042557.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
