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/9e27a1ed-e81a-4918-b32b-0380cf3a9f8f/?format=api
{ "id": "9e27a1ed-e81a-4918-b32b-0380cf3a9f8f", "url": "https://ll.thespacedevs.com/2.2.0/launch/9e27a1ed-e81a-4918-b32b-0380cf3a9f8f/?format=api", "slug": "mir-demo-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Mir | Demo Flight", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2026-07-03T13:39:06Z", "updates": [ { "id": 15441, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Scrubbed for the day.", "info_url": "https://www.chosun.com/politics/politics_general/2026/06/30/N5UJTIOJDJCFVAONAODI6B4HNY", "created_by": "Cosmic_Penguin", "created_on": "2026-06-30T14:48:00Z" }, { "id": 15424, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET June 30 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2801001#msg2801001", "created_by": "Cosmic_Penguin", "created_on": "2026-06-28T13:45:00Z" }, { "id": 15346, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET June 29 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2799745#msg2799745", "created_by": "Cosmic_Penguin", "created_on": "2026-06-23T13:23:00Z" }, { "id": 15181, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted to NET June with cancellation of NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2794966#msg2794966", "created_by": "Cosmic_Penguin", "created_on": "2026-06-04T12:41:00Z" }, { "id": 15140, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET June 8 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2793613#msg2793613", "created_by": "Cosmic_Penguin", "created_on": "2026-05-30T01:10:00Z" }, { "id": 15100, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Set launch to GO with release of NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2792279#msg2792279", "created_by": "Cosmic_Penguin", "created_on": "2026-05-26T15:17:00Z" }, { "id": 15027, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET June 1, TBC.", "info_url": "https://x.com/kyovon_16/status/2057310468164014552", "created_by": "Cosmic_Penguin", "created_on": "2026-05-21T21:31:00Z" }, { "id": 14988, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted back to NET May due to lack of NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2789239#msg2789239", "created_by": "Cosmic_Penguin", "created_on": "2026-05-17T15:00:00Z" }, { "id": 14924, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET May 20, TBC.", "info_url": "https://twitter.com/kyovon_16/status/2053124210801963301", "created_by": "Cosmic_Penguin", "created_on": "2026-05-09T23:08:00Z" }, { "id": 14778, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET May.", "info_url": "https://n.news.naver.com/article/003/0013902614?sid=102", "created_by": "Cosmic_Penguin", "created_on": "2026-04-22T03:01:00Z" }, { "id": 14727, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET April 25 due to launch site weather.", "info_url": "https://n.news.naver.com/article/079/0004137628?sid=102", "created_by": "Cosmic_Penguin", "created_on": "2026-04-17T02:58:00Z" }, { "id": 14654, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; payload details TBD.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64752.msg2779045#msg2779045", "created_by": "Cosmic_Penguin", "created_on": "2026-04-11T15:26:00Z" } ], "net": "2026-07-31T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2026-07-31T00:00:00Z", "window_start": "2026-07-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1079, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "ADD", "description": "The Agency for Defense Development (ADD) is the South Korean national agency for research and development in defense technology, funded by the Defense Acquisition Program Administration (DAPA). Its purpose is contributing to enforcing the national defence, to improving the national R&D capacity, and to fostering the domestic defense industry.", "administrator": null, "founding_year": "1970", "launchers": "South Korean ADD Solid-Fuel SLV", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg" }, "rocket": { "id": 8972, "configuration": { "id": 502, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/502/?format=api", "name": "Mir", "active": true, "reusable": false, "description": "Mir (Korean for a kind of dragon, and previously only known as \"Solid-fuel space launch vehicle\") is a South Korean military developed small satellite launch vehicle for \"quick response\" usage. First orbital test launch in December 2023 omits the 2nd stage but still carries satellite into orbit.", "family": "Mir", "full_name": "Mir", "manufacturer": { "id": 1079, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "ADD", "description": "The Agency for Defense Development (ADD) is the South Korean national agency for research and development in defense technology, funded by the Defense Acquisition Program Administration (DAPA). Its purpose is contributing to enforcing the national defence, to improving the national R&D capacity, and to fostering the domestic defense industry.", "administrator": null, "founding_year": "1970", "launchers": "South Korean ADD Solid-Fuel SLV", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg" }, "program": [], "variant": "", "alias": "South Korean ADD Solid-Fuel SLV", "min_stage": 4, "max_stage": 4, "length": null, "diameter": null, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 500, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Solid-fuel_space_launch_vehicle", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7567, "name": "Demo Flight", "description": "Note: Launch vehicle name is provisional.\r\n\r\nFirst orbital full version launch of the South Korean military small satellite launch vehicle, after 2 sub-orbital tests of individual stages on 30 March and 30 December 2022, and 1 orbital test flight without the 2nd stage on 4 December 2023. Details TBD.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 216, "url": "https://ll.thespacedevs.com/2.2.0/pad/216/?format=api", "agency_id": null, "name": "ADD Offshore launch platform", "description": "Offshore launch platform for the South Korean military small satellite launch vehicle.", "info_url": null, "wiki_url": null, "map_url": null, "latitude": "33.216667", "longitude": "126.366667", "location": { "id": 3, "url": "https://ll.thespacedevs.com/2.2.0/location/3/?format=api", "name": "Sea Launch", "country_code": "???", "description": "", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg", "timezone_name": "", "total_launch_count": 40, "total_landing_count": 0 }, "country_code": "KOR", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_add_offshore_launch_platform_20231204142359.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 7357, "location_launch_attempt_count": 41, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 184, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P969DT19H", "mission_patches": [], "type": "detailed" }
