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/628749e8-b535-4483-9a3b-9a93b1b0c6d1/?format=api
{ "id": "628749e8-b535-4483-9a3b-9a93b1b0c6d1", "url": "https://ll.thespacedevs.com/2.2.0/launch/628749e8-b535-4483-9a3b-9a93b1b0c6d1/?format=api", "slug": "nuri-neonsat-7-to-11", "flightclub_url": null, "r_spacex_api_id": null, "name": "Nuri | NeonSat-7 to 11", "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": "2025-12-09T17:09:20Z", "updates": [ { "id": 13210, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://www.yna.co.kr/view/AKR20250918087300017", "created_by": "Cosmic_Penguin", "created_on": "2025-12-09T17:09:00Z" } ], "net": "2027-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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" }, "rocket": { "id": 8849, "configuration": { "id": 117, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/117/?format=api", "name": "Nuri", "active": true, "reusable": false, "description": "Nuri, also known as KSLV-II, is South Korea's second carrier rocket and the successor to KSLV-1.", "family": "KSLV", "full_name": "KSLV-2 Nuri", "manufacturer": { "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" }, "program": [], "variant": "2", "alias": "", "min_stage": 3, "max_stage": 3, "length": 47.2, "diameter": 3.5, "maiden_flight": "2021-10-21", "launch_cost": null, "launch_mass": 200, "leo_capacity": 2600, "gto_capacity": null, "to_thrust": 2612, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_on_the_lau_image_20240307163812.jpeg", "info_url": "https://www.kari.re.kr/eng/sub03_03_01.do", "wiki_url": "https://en.wikipedia.org/wiki/KSLV-2", "total_launch_count": 4, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 1, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7440, "name": "NeonSat-7 to 11", "description": "NeonSat-7 to 11 are part of the South Korean government's Earth observation micro-satellite constellation NeonSat (New-space Earth Observation Satellite). The NeonSat constellation is the first satellite system developed by the government using a mass-production approach for precise monitoring of the Korean Peninsula.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 192, "url": "https://ll.thespacedevs.com/2.2.0/pad/192/?format=api", "agency_id": 41, "name": "LC-2", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Naro_Space_Center", "map_url": "https://www.google.com/maps?q=34.431867,127.535069", "latitude": "34.431867", "longitude": "127.535069", "location": { "id": 9, "url": "https://ll.thespacedevs.com/2.2.0/location/9/?format=api", "name": "Naro Space Center, South Korea", "country_code": "KOR", "description": "The Naro Space Center is a South Korean spaceport in South Jeolla's Goheung County, operated by the state-run Korea Aerospace Research Institute.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_9_20200803142441.jpg", "timezone_name": "Asia/Seoul", "total_launch_count": 8, "total_landing_count": 0 }, "country_code": "KOR", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_lc-2_20210812070305.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 4 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_liftoff_2_image_20240820080542.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7448, "location_launch_attempt_count": 10, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 10, "orbital_launch_attempt_count_year": 67, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P457D", "mission_patches": [], "type": "detailed" }
