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://lldev.thespacedevs.com/2.2.0/launch/9e27a1ed-e81a-4918-b32b-0380cf3a9f8f/?format=api", "slug": "south-korean-add-solid-fuel-slv-demo-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "South Korean ADD Solid-Fuel SLV | Demo Flight", "status": { "id": 8, "name": "To Be Confirmed", "abbrev": "TBC", "description": "Awaiting official confirmation - current date is known with some certainty." }, "last_updated": "2026-04-11T15:26:39Z", "updates": [ { "id": 14654, "profile_image": "https://thespacedevs-dev.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-04-22T05:00:00Z", "net_precision": { "id": 2, "name": "Hour", "abbrev": "HR", "description": "The T-0 is accurate to the hour." }, "window_end": "2026-04-22T09:00:00Z", "window_start": "2026-04-22T05:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1079, "url": "https://lldev.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": 0, "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-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg" }, "rocket": { "id": 8972, "configuration": { "id": 502, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/502/?format=api", "name": "South Korean ADD Solid-Fuel SLV", "active": false, "reusable": false, "description": "", "family": "South Korean ADD Solid-Fuel SLV", "full_name": "South Korean ADD Solid-Fuel SLV", "manufacturer": { "id": 1079, "url": "https://lldev.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": 0, "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-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg" }, "program": [], "variant": "", "alias": "", "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": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "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://lldev.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://lldev.thespacedevs.com/2.2.0/location/3/?format=api", "name": "Sea Launch", "country_code": "???", "description": "", "map_image": "https://thespacedevs-dev.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-dev.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-dev.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 7265, "location_launch_attempt_count": 41, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 92, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P870D", "mission_patches": [], "type": "detailed" }
