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": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-11-29T02:20:18Z", "updates": [ { "id": 13052, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success with main payload confirmed in contact.", "info_url": "https://x.com/kari2030/status/1993742969644708222", "created_by": "Cosmic_Penguin", "created_on": "2025-11-26T18:36:00Z" }, { "id": 13047, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Payloads deployed.", "info_url": "https://www.youtube.com/watch?v=dsp3N-QY6-A", "created_by": "hitura-nobad", "created_on": "2025-11-26T16:33:00Z" }, { "id": 13046, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Liftoff!", "info_url": "https://www.youtube.com/watch?v=FwdPEiTr7hQ", "created_by": "hitura-nobad", "created_on": "2025-11-26T16:13:00Z" }, { "id": 13045, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "New T-0 16:13:00 UTC, due to abnorminal pressure value.", "info_url": "https://www.youtube.com/watch?v=dsp3N-QY6-A", "created_by": "hitura-nobad", "created_on": "2025-11-26T15:52:00Z" }, { "id": 13041, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://www.youtube.com/watch?v=FwdPEiTr7hQ", "created_by": "Cosmic_Penguin", "created_on": "2025-11-26T13:09:00Z" }, { "id": 13040, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by 한국항공우주연구원 KARI TV has started", "info_url": "https://www.youtube.com/watch?v=FwdPEiTr7hQ", "created_by": "LL2", "created_on": "2025-11-26T13:00:00Z" }, { "id": 12415, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET November 26 UTC.", "info_url": "https://www.kasa.go.kr/bbs/BBSMSTR_000000000010/B000000002146Wf0gZ4.do?mno=sub01_01_01", "created_by": "Cosmic_Penguin", "created_on": "2025-09-30T04:30:00Z" }, { "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-26T16:13:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-11-26T16:14:00Z", "window_start": "2025-11-26T15:54: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": 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": 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": 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": 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": [ { "priority": 10, "source": "youtube.com", "publisher": "한국항공우주연구원 KARI TV", "title": "[공식] 누리호 4차 발사 현장 생중계", "description": "누리호의 네번째 도전!\n\n이제 누리호의 성능을 확인하기 위한 시험발사가 아닌, 우주로 갈 손님을 태우는 실전 발사입니다!\n\n13기의 위성과 함께 누리호가 다시 우주로 나아가는 모습을 생생하게 소개합니다!\n\n#한국항공우주연구원 #항우연 #kari #누리호 #4차발사 #발사생중계", "feature_image": "https://i.ytimg.com/vi/FwdPEiTr7hQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=FwdPEiTr7hQ", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 9, "name": "Korean", "code": "ko" }, "start_time": "2025-11-26T13:00:07Z", "end_time": "2025-11-26T18:15:09Z" } ], "webcast_live": false, "timeline": [ { "type": { "id": 10, "abbrev": "Liftoff", "description": "First upwards movement of the rocket" }, "relative_time": "P0D" }, { "type": { "id": 25, "abbrev": "Supersonic", "description": "Vehicle is supersonic" }, "relative_time": "PT49S" }, { "type": { "id": 11, "abbrev": "Max-Q", "description": "Maximum dynamic pressure" }, "relative_time": "PT1M9S" }, { "type": { "id": 13, "abbrev": "Stage 2 Separation", "description": "Separation of the second stage from the first" }, "relative_time": "PT2M5S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT3M54S" }, { "type": { "id": 74, "abbrev": "Stage 3 Separation", "description": "Separation of the third stage from the second" }, "relative_time": "PT4M32S" }, { "type": { "id": 76, "abbrev": "Stage 3 Cutoff", "description": "Third stage engine shuts down." }, "relative_time": "PT12M37S" }, { "type": { "id": 78, "abbrev": "Payload Deployment Sequence Start", "description": "Start of the payload deployment sequence" }, "relative_time": "PT13M27S" }, { "type": { "id": 79, "abbrev": "Payload Deployment Sequence End", "description": "End of the payload deployment sequence." }, "relative_time": "PT15M27S" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_liftoff_2_image_20240820080542.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7130, "location_launch_attempt_count": 8, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 281, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P916DT6H49M", "mission_patches": [], "type": "detailed" }
