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/f2775d28-8dd8-4efc-87c6-b8d41372202b/?format=api
{ "id": "f2775d28-8dd8-4efc-87c6-b8d41372202b", "url": "https://ll.thespacedevs.com/2.2.0/launch/f2775d28-8dd8-4efc-87c6-b8d41372202b/?format=api", "slug": "vega-c-kompsat-7", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | KOMPSAT-7", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-12-04T05:19:28Z", "updates": [ { "id": 13106, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://newsroom.arianespace.com/arianespace-successfully-launches-kompsat-7-satellite-with-vega-c?lang=eng", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T18:14:00Z" }, { "id": 13105, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Spacecraft separation.", "info_url": "https://www.youtube.com/watch?v=MdljBBrCS8o", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T18:06:00Z" }, { "id": 13100, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=MdljBBrCS8o", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T17:21:00Z" }, { "id": 13099, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://www.youtube.com/watch?v=MdljBBrCS8o", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T17:14:00Z" }, { "id": 13098, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by arianespace has started", "info_url": "https://www.youtube.com/watch?v=MdljBBrCS8o", "created_by": "LL2", "created_on": "2025-12-01T17:09:00Z" }, { "id": 13069, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to December 1st.", "info_url": "https://newsroom.arianespace.com/flight-vv28-new-launch-date", "created_by": "Cosmic_Penguin", "created_on": "2025-11-27T20:28:00Z" }, { "id": 12976, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Delayed to November 30", "info_url": "https://x.com/Arianespace/status/1991922996148371636", "created_by": "Nosu", "created_on": "2025-11-21T17:35:00Z" }, { "id": 12868, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting November 28 at 17:21 UTC.", "info_url": "https://newsroom.arianespace.com/arianespace-to-launch-kompsat-7-satellite-on-november-28-2025-with-vega-c", "created_by": "Nosu", "created_on": "2025-11-13T09:33:00Z" }, { "id": 11830, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET November 2025.", "info_url": "https://biz.chosun.com/en/en-science/2025/07/24/VBMP5QOW7RAP3CXYHERBNOVGCM/", "created_by": "Cosmic_Penguin", "created_on": "2025-08-11T12:14:00Z" }, { "id": 3442, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Vega-C Return To Flight now NET end of 2023.", "info_url": "https://www.esa.int/Newsroom/Press_Releases/Loss_of_flight_VV22_Independent_Enquiry_Commission_announces_conclusions", "created_by": "Cosmic_Penguin", "created_on": "2023-03-03T08:36:01Z" } ], "net": "2025-12-01T17:21:25Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-12-01T17:21:25Z", "window_start": "2025-12-01T17:21:25Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "VV28", "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": 324, "consecutive_successful_launches": 12, "successful_launches": 309, "failed_launches": 15, "pending_launches": 28, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.arianespace.com", "wiki_url": "https://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": 182, "configuration": { "id": 127, "url": "https://ll.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://ll.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": 23, "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-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.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-prod.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": 21, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 691, "name": "KOMPSAT-7", "description": "KOMPSAT-7 is the follow-up model of KOMPSAT-3A whose mission is to provide high-resolution satellite images to satisfy South-Korea's governmental and institutional needs.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api", "name": "Korea Aerospace Research Institute", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "KARI", "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.", "administrator": "Administrator: Lee Sang-Ryool", "founding_year": "1989", "launchers": "Nuri", "spacecraft": "", "launch_library_url": null, "total_launch_count": 8, "consecutive_successful_launches": 3, "successful_launches": 5, "failed_launches": 3, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.kari.kr/", "wiki_url": "https://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://ll.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://ll.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-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 330, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.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://newsroom.arianespace.com/vega-c-flight-vv28", "type": { "id": 2, "name": "Official Press Kit" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "arianespace", "title": "Flight VV28 | KOMPSAT-7 | Vega C | Arianespace", "description": "On December 1st, 2025, at 2:21 p.m. local time (5:21 p.m. UTC, 6:21 p.m. CET), Arianespace is to launch KOMPSAT-7 (KOrea Multi-Purpose SATellite-7) satellite. This mission, called “VV28” will be performed using an Arianespace operated Vega C rocket, launched from Europe's Spaceport in French Guiana.\nKOMPSAT-7 will be placed in Sun-synchronous orbit. The expected total duration of the mission (from lift-off to separation of the satellite) is 45 minutes.\n\n► Subscribe to our channel to keep on touch on our futur contents: https://www.youtube.com/c/arianespace/featured\n\n► Arianespace is the world’s leading satellite launch company. Founded in 1980, it deploys a family of three launchers – Ariane and Vega – to meet the needs of commercial and government customers.\n\n► Follow this link to di...", "feature_image": "https://i.ytimg.com/vi/MdljBBrCS8o/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=MdljBBrCS8o", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2025-12-01T17:08:34Z", "end_time": "2025-12-01T18:12:41Z" } ], "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": "PT2M29S" }, { "type": { "id": 74, "abbrev": "Stage 3 Separation", "description": "Separation of the third stage from the second" }, "relative_time": "PT4M35S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT4M46S" }, { "type": { "id": 30, "abbrev": "Kick Stage Separation", "description": "Separation of the kick stage from the previous stage" }, "relative_time": "PT7M21S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT7M28S" }, { "type": { "id": 33, "abbrev": "Kick Stage Cut-off", "description": "Cut-off of the kick stage engine" }, "relative_time": "PT17M" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT40M23S" }, { "type": { "id": 33, "abbrev": "Kick Stage Cut-off", "description": "Cut-off of the kick stage engine" }, "relative_time": "PT42M41S" }, { "type": { "id": 35, "abbrev": "Payload Separation", "description": "Final deployment of the payload from the rocket" }, "relative_time": "PT43M54S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT1H51M" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7135, "location_launch_attempt_count": 329, "pad_launch_attempt_count": 54, "agency_launch_attempt_count": 323, "orbital_launch_attempt_count_year": 286, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 6, "pad_turnaround": "P128DT15H17M37S", "mission_patches": [ { "id": 1236, "name": "VV28 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/vv282520patch_mission_patch_20251128135812.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
