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/5c7280f6-b793-4899-a6fe-1d274ed46493/?format=api
{ "id": "5c7280f6-b793-4899-a6fe-1d274ed46493", "url": "https://ll.thespacedevs.com/2.2.0/launch/5c7280f6-b793-4899-a6fe-1d274ed46493/?format=api", "slug": "nuri-cas500-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "Nuri | CAS500-3", "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-01-27T23:00:13Z", "updates": [ { "id": 9927, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=45923.msg2636872#msg2636872", "created_by": "Cosmic_Penguin", "created_on": "2025-01-27T23:00:00Z" } ], "net": "2025-11-30T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2025-11-30T00:00:00Z", "window_start": "2025-11-30T00: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": 7, "consecutive_successful_launches": 2, "successful_launches": 4, "failed_launches": 3, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.kari.kr/", "wiki_url": "http://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": 8507, "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": 7, "consecutive_successful_launches": 2, "successful_launches": 4, "failed_launches": 3, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.kari.kr/", "wiki_url": "http://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": 3, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 1, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7096, "name": "CAS500-3", "description": "CAS500-3 is a South Korean Earth observation satellites to be used by the Ministry of Science and ICT for space technology verification and space science research.", "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": 7, "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": 4, "orbital_launch_attempt_count": 3 }, "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": 7006, "location_launch_attempt_count": 8, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 157, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P919DT14H36M", "mission_patches": [], "type": "detailed" }
