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/6bd4d3d9-d76d-4348-99d3-fad749b6b863/?format=api
{ "id": "6bd4d3d9-d76d-4348-99d3-fad749b6b863", "url": "https://ll.thespacedevs.com/2.2.0/launch/6bd4d3d9-d76d-4348-99d3-fad749b6b863/?format=api", "slug": "soyuz-21bfregat-m-oneweb-5", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b/Fregat-M | OneWeb 5", "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-05T18:23:55Z", "updates": [ { "id": 409, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Success confirmed", "info_url": "https://twitter.com/arianespaceceo/status/1374989315953065991", "created_by": "SwGustav", "created_on": "2021-03-25T07:41:05Z" }, { "id": 361, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Adding T-0 and setting go", "info_url": "https://www.arianespace.com/press-release/st30-announce/", "created_by": "SwGustav", "created_on": "2021-03-19T07:58:23Z" }, { "id": 223, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "", "info_url": "https://twitter.com/katlinegrey/status/1353953167617257473?s=19", "created_by": "Nosu", "created_on": "2021-01-26T21:00:54Z" } ], "net": "2021-03-25T02:47:33Z", "net_precision": null, "window_end": "2021-03-25T02:47:33Z", "window_start": "2021-03-25T02:47:33Z", "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": 2601, "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": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1243, "name": "OneWeb 5", "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": 83, "url": "https://ll.thespacedevs.com/2.2.0/pad/83/?format=api", "agency_id": 63, "name": "Cosmodrome Site 1S", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome", "map_url": "https://www.google.com/maps?q=51.884395,128.333932", "latitude": "51.884395", "longitude": "128.333932", "location": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/location/18/?format=api", "name": "Vostochny Cosmodrome, Siberia, Russian Federation", "country_code": "RUS", "description": "The Vostochny Cosmodrome is a Russian spaceport above the 51st parallel north in the Amur Oblast, in the Russian Far East. It is intended to reduce Russia's dependency on the Baikonur Cosmodrome in Kazakhstan. The first launch took place on 28 April 2016 at 02:01 UTC.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg", "timezone_name": "Asia/Yakutsk", "total_launch_count": 19, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg", "total_launch_count": 18, "orbital_launch_attempt_count": 18 }, "infoURLs": [], "vidURLs": [ { "priority": 8, "source": null, "publisher": null, "title": "Lift-off of Launch #5 for OneWeb", "description": "Lift-off of OneWeb's 5th launch from the Vostochny Cosmodrome on 25 March, 2021 at 2:47AM GMT.", "feature_image": "https://i.ytimg.com/vi/hczIpBMAkyQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=hczIpBMAkyQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "Arianespace Flight ST30 - OneWeb (EN)", "description": "Flight ST30, the second commercial mission performed by Arianespace and its Starsem affiliate from the Vostochny Cosmodrome, will put 36 of OneWeb’s satellit...", "feature_image": "https://i.ytimg.com/vi/67JFcTyn_aY/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=67JFcTyn_aY", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "OneWeb Launch 5 Livestream", "description": "", "feature_image": "https://i.ytimg.com/vi/I8Jey76akIk/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=I8Jey76akIk", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Пуск ракеты-носителя «Союз-2.1Б» со спутниками OneWeb с космодрома Восточный", "description": "С космодрома Восточный 25 марта 2021 года в 05:47 по московскому времени запланирован пуск ракеты-носителя «Союз-2.1Б» с разгонным блоком «Фрегат» и новой па...", "feature_image": "https://i.ytimg.com/vi/XMbEKthVx20/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=XMbEKthVx20", "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": 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": 6063, "location_launch_attempt_count": 7, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 293, "orbital_launch_attempt_count_year": 26, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P96DT14H21M6S", "mission_patches": [ { "id": 159, "name": "OneWeb 5 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/oneweb2520525_mission_patch_20211031042559.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
