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/54c50fe1-bbd1-4515-9630-37612383c3c1/?format=api
{ "id": "54c50fe1-bbd1-4515-9630-37612383c3c1", "url": "https://ll.thespacedevs.com/2.2.0/launch/54c50fe1-bbd1-4515-9630-37612383c3c1/?format=api", "slug": "soyuz-21afregat-m-cas500-1-rideshare", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1a/Fregat-M | CAS500-1 & rideshare", "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:30:59Z", "updates": [ { "id": 401, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch success confirmed by Roscosmos.", "info_url": "https://twitter.com/roscosmos/status/1373965436111425536?s=20", "created_by": "Nosu", "created_on": "2021-03-22T12:01:25Z" }, { "id": 397, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Delayed by a day", "info_url": "https://twitter.com/roscosmos/status/1373310356538417154", "created_by": "SwGustav", "created_on": "2021-03-20T16:36:26Z" }, { "id": 363, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Setting GO for new backup", "info_url": "https://twitter.com/roscosmos/status/1373153387429134339", "created_by": "SwGustav", "created_on": "2021-03-20T06:42:49Z" }, { "id": 362, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch scrubbed", "info_url": "https://twitter.com/gk_launch/status/1373145060687147008", "created_by": "Nosu", "created_on": "2021-03-20T05:45:07Z" }, { "id": 352, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch time and setting GO.", "info_url": "https://www.roscosmos.ru/30288/", "created_by": "Nosu", "created_on": "2021-03-13T07:45:23Z" }, { "id": 207, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch date update", "info_url": "https://twitter.com/gk_launch/status/1351194118416953344", "created_by": "Cosmic_Penguin", "created_on": "2021-01-18T16:30:23Z" } ], "net": "2021-03-22T06:07:12Z", "net_precision": null, "window_end": "2021-03-22T06:07:12Z", "window_start": "2021-03-22T06:07:12Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 187, "url": "https://ll.thespacedevs.com/2.2.0/agencies/187/?format=api", "name": "GK Launch Services", "featured": false, "type": "Commercial", "country_code": "RUS", "abbrev": "GKLS", "description": "GK Launch Services is a company established by Glavkosmos (a subsidiary of Roscosmos State Space Corporation) and International Space Company Kosmotras. GK Launch Services is an operator of Soyuz-2 commercial launches from the Russian spaceports.", "administrator": "CEO: Alexander V. Serkin", "founding_year": "2017", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://gklaunch.ru/en/", "wiki_url": null, "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gk2520launch2520services_logo_20210313165236.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gk_launch_servi_image_20210321182205.jpg", "nation_url": null }, "rocket": { "id": 2541, "configuration": { "id": 45, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/45/?format=api", "name": "Soyuz 2.1a/Fregat-M", "active": true, "reusable": false, "description": "The 2.1a version includes conversion from analog to digital flight control system and uprated engines on the booster and the first stage with improved injection systems. The new digital flight control and telemetry systems allow the rocket to launch from a fixed rather than angled launch platform and adjust its heading in flight. A digital control system also enables the launch of larger commercial satellites with wider and longer payload fairings such as the ST-type fairing. These fairings introduce too much aerodynamic instability for the old analog system to handle.", "family": "Soyuz", "full_name": "Soyuz 2.1a 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": 3, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2010-10-19", "launch_cost": "80000000", "launch_mass": 312, "leo_capacity": 7020, "gto_capacity": null, "to_thrust": 4149, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20190726062341.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2", "total_launch_count": 19, "consecutive_successful_launches": 9, "successful_launches": 18, "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": 1246, "name": "CAS500-1 & rideshare", "description": "CAS500-1 is the first of two South Korean Earth observation satellites. These spacecraft feature the AEISS-C imaging system with a ground resolution of 0.5 m in panchromatic mode and 2 m in color mode.\r\n\r\nMore than a dozen other satellites are included as secondary payloads, among them being the first spacecraft by the Catalan Space Agency.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "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": [], "vidURLs": [ { "priority": 8, "source": null, "publisher": null, "title": "Launch coverage of CAS500-1 spacecraft with Smallsats and Cubesats.", "description": "Live broadcast of the Soyuz-2.1a rocket/Fregat upper stage launch.Orbiting the CAS500-1 spacecraft and 37 SmallSats and CubeSats from 18 countries. The launc...", "feature_image": "https://i.ytimg.com/vi/J1nfIV-4_e8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=J1nfIV-4_e8", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "Трансляция пуска с космодрома Байконур ракеты-носителя «Союз-2.1а»", "description": "С космодрома Байконур на 22 марта 2021 года в 09:07 по московскому времени запланирован пуск ракеты-носителя «Союз-2.1а» с разгонным блоком «Фрегат», космиче...", "feature_image": "https://i.ytimg.com/vi/7wb12TG-K2Y/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=7wb12TG-K2Y", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "차세대중형위성 1호 발사 생중계", "description": "차세대중형위성 1호가 20일 오후 3시 7분에 발사됩니다.카자흐스탄 바이코누르 우주센터에서 소유즈 2.1a로 발사되는 차세대중형위성의 발사 모습을 생중계으로 전달 합니다.※ 본 생중계는 GK Launch Service에서 영어로 진행됩니다", "feature_image": "https://i.ytimg.com/vi/soW9Olij9k0/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=soW9Olij9k0", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20210321183012.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6060, "location_launch_attempt_count": 1518, "pad_launch_attempt_count": 390, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 23, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P21DT23H12M11S", "mission_patches": [ { "id": 114, "name": "CAS500-1 & rideshare Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/cas500-125202_mission_patch_20211031042448.PNG", "agency": { "id": 187, "url": "https://ll.thespacedevs.com/2.2.0/agencies/187/?format=api", "name": "GK Launch Services", "type": "Commercial" } } ], "type": "detailed" }
