Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__agency__ids, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/launches/9e27a1ed-e81a-4918-b32b-0380cf3a9f8f/?format=api
{ "id": "9e27a1ed-e81a-4918-b32b-0380cf3a9f8f", "url": "https://lldev.thespacedevs.com/2.3.0/launches/9e27a1ed-e81a-4918-b32b-0380cf3a9f8f/?format=api", "name": "South Korean ADD Solid-Fuel SLV | Demo Flight", "response_mode": "detailed", "slug": "south-korean-add-solid-fuel-slv-demo-flight", "launch_designator": null, "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", "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", "image": { "id": 1338, "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png", "credit": "Yonhap", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1079, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "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": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] }, "rocket": { "id": 8972, "configuration": { "response_mode": "detailed", "id": 502, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/502/?format=api", "name": "South Korean ADD Solid-Fuel SLV", "families": [ { "response_mode": "detailed", "id": 146, "name": "South Korean ADD Solid-Fuel SLV", "manufacturer": [ { "response_mode": "normal", "id": 1079, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "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": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2023-12-04", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "South Korean ADD Solid-Fuel SLV", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1079, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "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": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": null, "description": "", "alias": "", "min_stage": 4, "max_stage": 4, "length": null, "diameter": null, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 500.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": 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, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 7567, "name": "Demo Flight", "type": "Test 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.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 216, "url": "https://lldev.thespacedevs.com/2.3.0/pads/216/?format=api", "active": true, "agencies": [], "name": "ADD Offshore launch platform", "image": { "id": 1338, "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png", "credit": "Yonhap", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "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, "country": { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" }, "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, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 3, "url": "https://lldev.thespacedevs.com/2.3.0/locations/3/?format=api", "name": "Sea Launch", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7477, "successful_launches": 6922, "failed_launches": 555, "total_attempted_landings": 1292, "successful_landings": 1245, "failed_landings": 47 }, "active": true, "country": { "id": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 1418, "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192712.jpeg", "credit": "CASC", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 40, "total_landing_count": 0 } }, "webcast_live": false, "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, "flightclub_url": null, "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" } ], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P870D", "mission_patches": [] }
