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/1f79ce8e-dabc-4287-bb59-2a40f567c4e4/?format=api
{ "id": "1f79ce8e-dabc-4287-bb59-2a40f567c4e4", "url": "https://ll.thespacedevs.com/2.2.0/launch/1f79ce8e-dabc-4287-bb59-2a40f567c4e4/?format=api", "slug": "nuri-flight-test", "flightclub_url": null, "r_spacex_api_id": null, "name": "Nuri | Flight Test", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T04:30:54Z", "updates": [ { "id": 897, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Orbit wasn't actually achieved", "info_url": "https://en.yna.co.kr/view/AEN20211021006600320", "created_by": "SwGustav", "created_on": "2021-10-21T10:29:42Z" }, { "id": 895, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "The payload simulator was not placed into the correct orbit.", "info_url": "https://twitter.com/SpaceflightNow/status/1451115997298049025", "created_by": "SwGustav", "created_on": "2021-10-21T09:21:24Z" }, { "id": 894, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": null, "created_by": "SwGustav", "created_on": "2021-10-21T08:00:40Z" }, { "id": 879, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch time added per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=54990.msg2299632#msg2299632", "created_by": "Cosmic_Penguin", "created_on": "2021-10-14T05:02:19Z" }, { "id": 722, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch", "info_url": "https://twitter.com/kari2030/status/1425697417517625345?s=19", "created_by": "Cosmic_Penguin", "created_on": "2021-08-12T06:49:27Z" } ], "net": "2021-10-21T08:00:00Z", "net_precision": null, "window_end": "2021-10-21T10:20:00Z", "window_start": "2021-10-21T06:05:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Third stage failed to place the payload simulator into orbit, for unknown reason.", "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": 2994, "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": 1419, "name": "Flight Test", "description": "Maiden flight of the KSLV-II \"Nuri\" launch vehicle, carrying a dummy Payload of 1500 kg to sun-synchronous orbit.", "launch_designator": null, "type": "Test Flight", "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": [ { "priority": 0, "source": null, "publisher": null, "title": "Nuri Test Flight", "description": "Nuri Test Flight with initial coverage and post coverage cutThumbnail Photo Credit: Korea Aerospace Research Institute", "feature_image": "https://i.ytimg.com/vi/IxAqfvkn0oQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=IxAqfvkn0oQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "누리호 1차 시험 발사 장면", "description": "누리호 1차 시험 발사 장면", "feature_image": "https://i.ytimg.com/vi/7PWTnX0EwcU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=7PWTnX0EwcU", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "[LIVE] NURI LIFT-OFF S. KOREA'S 1st HOMEGROWN SPACE ROCKET", "description": "🔊 [LIVE] NURI LIFT-OFF S. KOREA'S 1st HOMEGROWN SPACE ROCKET🔊 [LIVE] 누리호 발사 온라인 생중계#SouthKorea #SPACE_ROCKET #누리호📣 Arirang News(Facebook) : https://www.fa...", "feature_image": "https://i.ytimg.com/vi/rFoWZ3GGOcs/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=rFoWZ3GGOcs", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nuri_on_the_lau_image_20240307163812.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6138, "location_launch_attempt_count": 5, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 101, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1058DT1H", "mission_patches": [], "type": "detailed" }
