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/b31313da-ee5d-42b2-9a27-20cc18105276/?format=api
{ "id": "b31313da-ee5d-42b2-9a27-20cc18105276", "url": "https://lldev.thespacedevs.com/2.2.0/launch/b31313da-ee5d-42b2-9a27-20cc18105276/?format=api", "slug": "vega-c-solar-wind-magnetosphere-ionosphere-link-ex", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | Solar wind Magnetosphere Ionosphere Link Explorer (SMILE)", "status": { "id": 1, "name": "Go for Launch", "abbrev": "Go", "description": "Current T-0 confirmed by official or reliable sources." }, "last_updated": "2026-04-03T06:34:03Z", "updates": [ { "id": 12660, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET April 8.", "info_url": "https://content-static.cctvnews.cctv.com/snow-book/index.html?item_id=310299416846572182", "created_by": "Cosmic_Penguin", "created_on": "2025-10-24T16:27:00Z" }, { "id": 10047, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting early 2026", "info_url": "https://orbitaltoday.com/2023/02/22/esa-china-smile-mission-passes-launch-tests/", "created_by": "Nosu", "created_on": "2025-02-07T22:10:00Z" }, { "id": 14369, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting April 9 at 06:29 UTC", "info_url": "https://www.esa.int/Science_Exploration/Space_Science/Smile/T-20_days_Smile_to_launch_on_9_April", "created_by": "Nosu", "created_on": "2026-03-20T10:04:00Z" }, { "id": 3377, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET April 2025", "info_url": "https://twitter.com/CNSpaceflight/status/1625179058177970183", "created_by": "Nosu", "created_on": "2023-02-23T17:01:47Z" }, { "id": 7415, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2025.", "info_url": "https://europeanspaceflight.com/esa-selects-grounded-vega-c-to-launch-smile-mission/", "created_by": "Cosmic_Penguin", "created_on": "2024-05-01T03:42:40Z" } ], "net": "2026-04-09T06:29:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2026-04-09T06:29:00Z", "window_start": "2026-04-09T06:29:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "VV29", "launch_service_provider": { "id": 159, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 24, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "https://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "rocket": { "id": 7792, "configuration": { "id": 127, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/127/?format=api", "name": "Vega-C", "active": true, "reusable": false, "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.", "family": "Vega", "full_name": "Vega-C", "manufacturer": { "id": 159, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 24, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "https://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 4, "max_stage": 4, "length": 34.8, "diameter": 3.0, "maiden_flight": "2022-07-13", "launch_cost": "48000000", "launch_mass": 210, "leo_capacity": 3300, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "info_url": "https://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 6, "consecutive_successful_launches": 4, "successful_launches": 5, "failed_launches": 1, "pending_launches": 23, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6309, "name": "Solar wind Magnetosphere Ionosphere Link Explorer (SMILE)", "description": "Joint mission between the European Space Agency and the Chinese Academy of Sciences to investigate the interaction between Earth’s protective shield – the magnetosphere – and the supersonic solar wind.", "launch_designator": null, "type": "Astrophysics", "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical" }, "agencies": [ { "id": 1106, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1106/?format=api", "name": "Chinese Academy of Sciences", "featured": false, "type": "Government", "country_code": "CHN", "abbrev": "CAS", "description": "The Chinese Academy of Sciences (CAS; Chinese: 中国科学院) is the national academy for natural sciences and the highest consultancy for science and technology of the People's Republic of China.", "administrator": "President: Hou Jianguo", "founding_year": "1949", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.cas.cn/", "wiki_url": "https://en.wikipedia.org/wiki/Chinese_Academy_of_Sciences", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china_academy_o_image_20260403063134.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china_academy_o_image_20260403063203.png" }, { "id": 27, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,BEL,SVN", "abbrev": "ESA", "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.", "administrator": "Director General: Josef Aschbacher", "founding_year": "1975", "launchers": "Ariane | Vega", "spacecraft": "Space Rider", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.esa.int/", "wiki_url": "https://en.wikipedia.org/wiki/European_Space_Agency", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://lldev.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "location": { "id": 13, "url": "https://lldev.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 331, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg", "total_launch_count": 54, "orbital_launch_attempt_count": 54 }, "infoURLs": [ { "priority": 10, "source": null, "title": null, "description": null, "feature_image": null, "url": "https://www.avio.com/sites/avio.com/files/downloads/LAUNCH-KIT%20VV29%20-%20ENG.pdf", "type": { "id": 2, "name": "Official Press Kit" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "European Space Agency, ESA", "title": "ESA's Smile mission launch", "description": "Join us live on 9 April, as we broadcast the launch of the European-Chinese Smile mission.\n \nSmile will head to space on a Vega-C rocket from Europe's Spaceport in French Guiana.\n \nThis stream will include live launch footage from the launchpad and control room, as well as real-time interviews with people involved in the mission and its launch.\n \nFor the first time, Smile is going to reveal what really happens when charged particles from the Sun crash into Earth's magnetic shield.\n \nIt carries an X-ray camera to make the first X-ray observations of how exactly this shield responds to the solar wind, and an ultraviolet camera to watch the resulting northern lights for 45 hours at a time.\n \nFind out more at esa.int/smile\n\n★ Subscribe: http://bit.ly/ESAsubscribe and click twice on the be...", "feature_image": "https://i.ytimg.com/vi/6q8aKbcKCOs/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=6q8aKbcKCOs", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2026-04-09T06:10:00Z", "end_time": null } ], "webcast_live": false, "timeline": [ { "type": { "id": 10, "abbrev": "Liftoff", "description": "First upwards movement of the rocket" }, "relative_time": "P0D" }, { "type": { "id": 13, "abbrev": "Stage 2 Separation", "description": "Separation of the second stage from the first" }, "relative_time": "PT2M24S" }, { "type": { "id": 74, "abbrev": "Stage 3 Separation", "description": "Separation of the third stage from the second" }, "relative_time": "PT4M31S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT4M42S" }, { "type": { "id": 30, "abbrev": "Kick Stage Separation", "description": "Separation of the kick stage from the previous stage" }, "relative_time": "PT7M13S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT20M23S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT52M57S" }, { "type": { "id": 35, "abbrev": "Payload Separation", "description": "Final deployment of the payload from the rocket" }, "relative_time": "PT56M24S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT2H37S" } ], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7256, "location_launch_attempt_count": 332, "pad_launch_attempt_count": 55, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 83, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P128DT13H7M35S", "mission_patches": [], "type": "detailed" }