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/1eeafaec-b6c2-45c1-92c6-1b447408f755/?format=api
{ "id": "1eeafaec-b6c2-45c1-92c6-1b447408f755", "url": "https://ll.thespacedevs.com/2.2.0/launch/1eeafaec-b6c2-45c1-92c6-1b447408f755/?format=api", "slug": "soyuz-21afregat-kanopus-v-ik", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz-2.1a/Fregat | Kanopus-V-IK", "status": { "id": 7, "name": "Launch was a Partial Failure", "abbrev": "Partial Failure", "description": "Either the launch vehicle reached orbit but did not deliver its payload in the targeted orbit, or an exceptional event made it impossible to consider the mission a success." }, "last_updated": "2023-06-14T03:41:33Z", "updates": [], "net": "2017-07-14T06:36:49Z", "net_precision": null, "window_end": "2017-07-14T06:36:49Z", "window_start": "2017-07-14T06:36:49Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "Numerous payloads experienced technical problems after an upper stage anomaly.", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "RFSA", "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": "1992", "launchers": "Soyuz", "spacecraft": "Soyuz", "launch_library_url": null, "total_launch_count": 331, "consecutive_successful_launches": 55, "successful_launches": 320, "failed_launches": 11, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://en.roscosmos.ru/", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 2017, "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": 375, "name": "Kanopus-V-IK", "description": "Kanopus-V-IK is a small Russian remote sensing satellite for monitoring wildfires. Weighing about 473 kg, it is intended for 5 years of operation in a 510 km sun-synchronous orbit.", "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": 0, "source": null, "publisher": null, "title": "Пуск РКН «Союз-2.1а» с КА «Канопус-В-ИК» и 72 малыми спутниками", "description": "14 июля 2017 года в 9:36 мск с космодрома Байконур успешно стартовала ракета-носитель «Союз-2.1а» с космическим аппаратом дистанционного зондирования Земли «...", "feature_image": "https://i.ytimg.com/vi/E0X0KfEnJAk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=E0X0KfEnJAk", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Запуск ракеты-носителя \"Союз-2.1а\" с космодрома Байконур 14.07.17", "description": "14 июля 2017 года в 9:36 по московскому времени состоялся запуск с космодрома Байконур ракеты-носителя (РН) \"Союз-2.1а\" с космическим аппаратом \"Канопус-В-ИК...", "feature_image": "https://i.ytimg.com/vi/-qC9WMcbwV0/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=-qC9WMcbwV0", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Пуск РКН «Союз-2.1а» (сборник HD)", "description": "Сборник видео пуска РКН «Союз-2.1а» с КА «Канопус-В-ИК» и 72 малыми спутниками. 7 точек съемки. Запуск космических аппаратов состоялся 14 июля 2017 года в 9:...", "feature_image": "https://i.ytimg.com/vi/V5yA7FtqQAo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=V5yA7FtqQAo", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Flock 2k Launch", "description": "We pointed an on-orbit Dove satellite towards the Baikonur Cosmodrome to capture the images used in this animation of the launch of our latest flock of 48 sa...", "feature_image": "https://i.ytimg.com/vi/afiLd4zPoLQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=afiLd4zPoLQ", "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_20190726062341.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 5660, "location_launch_attempt_count": 1478, "pad_launch_attempt_count": 372, "agency_launch_attempt_count": 265, "orbital_launch_attempt_count_year": 45, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P29DT21H16M36S", "mission_patches": [], "type": "detailed" }
