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/20054280-a20a-457e-b452-8a176f633907/?format=api
{ "id": "20054280-a20a-457e-b452-8a176f633907", "url": "https://ll.thespacedevs.com/2.2.0/launch/20054280-a20a-457e-b452-8a176f633907/?format=api", "slug": "angara-a5blok-dm-03-dummy-payload", "flightclub_url": null, "r_spacex_api_id": null, "name": "Angara A5/Blok DM-03 | Dummy payload", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2024-01-02T16:36:52Z", "updates": [ { "id": 1121, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch outcome update, upper stage stranded in LEO after failing to restart.", "info_url": "https://twitter.com/russianspaceweb/status/1475704959165349889?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-12-28T06:00:44Z" }, { "id": 1118, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Lift off per insider source", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2320752", "created_by": "spacevogel", "created_on": "2021-12-27T19:03:00Z" }, { "id": 1117, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Back on Dec. 27.", "info_url": "https://twitter.com/katlinegrey/status/1475366190239334402?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-12-27T07:44:57Z" }, { "id": 1116, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date per insider sources.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2320370", "created_by": "Cosmic_Penguin", "created_on": "2021-12-27T06:35:32Z" }, { "id": 1113, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "New date per insider sources, keeping TBC status until new info is available", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?topic=16307.msg2319442#msg2319442", "created_by": "spacevogel", "created_on": "2021-12-25T09:57:09Z" }, { "id": 1112, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Scrub per insider source, pushing 24 hr in the launch window until new info on next attempt is available", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?topic=18852.msg2319236#msg2319236", "created_by": "spacevogel", "created_on": "2021-12-24T15:12:20Z" }, { "id": 1109, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Previously mentioned NOTAMs are not for delayed date, but extension of the launch window. Launch is still go for today per insider sources.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?topic=18852.msg2319016#msg2319016", "created_by": "spacevogel", "created_on": "2021-12-24T09:00:09Z" }, { "id": 1108, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "NET December 27 per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=47428.msg2324490#msg2324490", "created_by": "Jay", "created_on": "2021-12-24T01:01:09Z" }, { "id": 1106, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Go for launch.", "info_url": "https://twitter.com/russianspaceweb/status/1474012469806915591?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-12-23T13:46:08Z" }, { "id": 1098, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "One day slip due to ground equipment and weather.", "info_url": "https://tass.com/science/1378833", "created_by": "Cosmic_Penguin", "created_on": "2021-12-21T23:22:31Z" }, { "id": 1057, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch date/time per local drop zone evacuation notices.", "info_url": "https://www.tvtomsk.ru/news/73075-fragmenty-rakety-angara-a5-mogut-upast-na-territorii-tomskoj-oblasti.html", "created_by": "Cosmic_Penguin", "created_on": "2021-12-09T09:27:20Z" } ], "net": "2021-12-27T19:00:00Z", "net_precision": null, "window_end": "2021-12-27T19:00:00Z", "window_start": "2021-12-27T19:00:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "Upper stage failed to restart for 2nd burn leaving upper stage & payload simulator in LEO. As the resulting orbit would be completely unsalvageable by a hypothetical real payload, and the main purpose of the launch was to test the Persey upper stage, it should be considered a failure.", "hashtag": null, "launch_service_provider": { "id": 96, "url": "https://ll.thespacedevs.com/2.2.0/agencies/96/?format=api", "name": "Khrunichev State Research and Production Space Center", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "KhSC", "description": "Khrunichev State Research and Production Space Center is a Moscow-based producer of spacecraft and space-launch systems, including the Proton and Rokot rockets and is currently developing the Angara rocket family. The Proton launch vehicle launches from Baikonur and Rokot launches from Baikonur and Plesetsk. Angara will launch from Plesetsk and Vostochny.", "administrator": "Director: Andrey Vladimirovich Kalinovskiy", "founding_year": "1916", "launchers": "Proton | Rokot", "spacecraft": "", "launch_library_url": null, "total_launch_count": 196, "consecutive_successful_launches": 7, "successful_launches": 181, "failed_launches": 15, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.khrunichev.ru/main.php?lang=en", "wiki_url": "http://en.wikipedia.org/wiki/Khrunichev_State_Research_and_Production_Space_Center", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg" }, "rocket": { "id": 2562, "configuration": { "id": 196, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/196/?format=api", "name": "Angara A5/Blok DM-03", "active": true, "reusable": false, "description": "Angara A5/Blok DM-03 is an Angara A5 with an improved Blok DM-03 RP-1/LOX upper stage. There are 2 variants for the DM-03: the Persey for launches from the Plesetsk Cosmodrome, and the Orion for launches from the Vostochny Cosmodrome.", "family": "Angara", "full_name": "Angara A5/Blok DM-03", "manufacturer": { "id": 96, "url": "https://ll.thespacedevs.com/2.2.0/agencies/96/?format=api", "name": "Khrunichev State Research and Production Space Center", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "KhSC", "description": "Khrunichev State Research and Production Space Center is a Moscow-based producer of spacecraft and space-launch systems, including the Proton and Rokot rockets and is currently developing the Angara rocket family. The Proton launch vehicle launches from Baikonur and Rokot launches from Baikonur and Plesetsk. Angara will launch from Plesetsk and Vostochny.", "administrator": "Director: Andrey Vladimirovich Kalinovskiy", "founding_year": "1916", "launchers": "Proton | Rokot", "spacecraft": "", "launch_library_url": null, "total_launch_count": 196, "consecutive_successful_launches": 7, "successful_launches": 181, "failed_launches": 15, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.khrunichev.ru/main.php?lang=en", "wiki_url": "http://en.wikipedia.org/wiki/Khrunichev_State_Research_and_Production_Space_Center", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_logo_20190207032444.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_image_20190207032444.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev_stat_image_20240409071747.jpg" }, "program": [], "variant": "A5/DM-03", "alias": "", "min_stage": 3, "max_stage": 3, "length": 55.4, "diameter": 8.86, "maiden_flight": "2021-12-27", "launch_cost": "31000000", "launch_mass": 773, "leo_capacity": 24500, "gto_capacity": 7000, "to_thrust": 9600, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara_a5_on_si_image_20240409071243.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Angara_(rocket_family)", "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "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": 5908, "name": "Dummy payload", "description": "This is the third test flight of Angara A5 launch vehicle and its first flight with Persey upper stage. Since it's a test flight, the rocket carries a mass simulator payload.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 42, "url": "https://ll.thespacedevs.com/2.2.0/pad/42/?format=api", "agency_id": 163, "name": "35/1", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Plesetsk_Cosmodrome_Site_35", "map_url": "https://www.google.com/maps?q=62.927319,40.574897", "latitude": "62.927319", "longitude": "40.574897", "location": { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api", "name": "Plesetsk Cosmodrome, Russian Federation", "country_code": "RUS", "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "timezone_name": "Europe/Moscow", "total_launch_count": 1674, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_42_20200803143543.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Пуск ракеты «Ангара-А5» с космодрома Плесецк", "description": "Боевым расчетом Космических войск Воздушно-космических сил с космодрома Плесецк проведен пуск ракеты-носителя тяжелого класса «Ангара-А5».Все предстартовые о...", "feature_image": "https://i.ytimg.com/vi/0T_crwtWhe4/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=0T_crwtWhe4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/angara_a5_on_si_image_20240409071243.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6179, "location_launch_attempt_count": 1646, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 189, "orbital_launch_attempt_count_year": 142, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P378DT13H10M", "mission_patches": [], "type": "detailed" }
