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/7f854a08-ea51-4470-9b80-84fb2252c9fe/?format=api
{ "id": "7f854a08-ea51-4470-9b80-84fb2252c9fe", "url": "https://ll.thespacedevs.com/2.2.0/launch/7f854a08-ea51-4470-9b80-84fb2252c9fe/?format=api", "slug": "electron-live-and-let-fly-nrol-123", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | Live and Let Fly (NROL-123)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-22T07:12:19Z", "updates": [ { "id": 7033, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success confirmed.", "info_url": "https://twitter.com/rocketlab/status/1770729559215821105", "created_by": "Cosmic_Penguin", "created_on": "2024-03-21T08:35:06Z" }, { "id": 7032, "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=Coa3GZtotQo", "created_by": "hitura-nobad", "created_on": "2024-03-21T07:25:49Z" }, { "id": 7031, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Proceeding with launch at 07:25 UTC", "info_url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "created_by": "hitura-nobad", "created_on": "2024-03-21T07:04:14Z" }, { "id": 7030, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "T-0 set to 07:25 UTC, issue still being worked on", "info_url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "created_by": "hitura-nobad", "created_on": "2024-03-21T06:58:30Z" }, { "id": 7029, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "launch window extended", "info_url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "created_by": "hitura-nobad", "created_on": "2024-03-21T06:53:44Z" }, { "id": 7028, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Hold at T-04:36", "info_url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "created_by": "hitura-nobad", "created_on": "2024-03-21T06:37:50Z" }, { "id": 7027, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by Rocket Lab has started", "info_url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "created_by": "LL2", "created_on": "2024-03-21T06:11:11Z" }, { "id": 7025, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Adjusted launch window", "info_url": "https://www.rocketlabusa.com/assets/Uploads/Live-Let-Fly-Press-Kit.pdf", "created_by": "hitura-nobad", "created_on": "2024-03-20T17:32:02Z" }, { "id": 7017, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch weather.", "info_url": "https://twitter.com/NASAWallops/status/1770149631780892846", "created_by": "Cosmic_Penguin", "created_on": "2024-03-19T18:13:16Z" }, { "id": 7009, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://twitter.com/natreconofc/status/1769816107198599657", "created_by": "Cosmic_Penguin", "created_on": "2024-03-18T20:03:16Z" }, { "id": 6996, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Delayed by 1 day to march 21st", "info_url": "https://twitter.com/RocketLab/status/1768729926474375282", "created_by": "hitura-nobad", "created_on": "2024-03-15T21:07:20Z" }, { "id": 6991, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://www.rocketlabusa.com/missions/next-mission/", "created_by": "Cosmic_Penguin", "created_on": "2024-03-15T09:54:21Z" }, { "id": 6952, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch time.", "info_url": "https://www.rocketlabusa.com/missions/next-mission/", "created_by": "Cosmic_Penguin", "created_on": "2024-03-12T18:06:22Z" }, { "id": 6892, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch window officially confirmed.", "info_url": "https://twitter.com/natreconofc/status/1765735427678298330", "created_by": "Cosmic_Penguin", "created_on": "2024-03-07T15:11:11Z" }, { "id": 6884, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added tentative launch window per marine navigation warnings.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=60415.msg2574470#msg2574470", "created_by": "Cosmic_Penguin", "created_on": "2024-03-06T14:51:51Z" }, { "id": 6758, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Edited launch code name for the NRO.", "info_url": "https://twitter.com/NatReconOfc/status/1760273207242731688", "created_by": "Cosmic_Penguin", "created_on": "2024-02-21T12:42:23Z" }, { "id": 6757, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Added launch", "info_url": "https://investors.rocketlabusa.com/news/news-details/2024/Rocket-Lab-to-Launch-NRO-Mission-from-Wallops-Virginia/default.aspx", "created_by": "hitura-nobad", "created_on": "2024-02-21T12:19:54Z" } ], "net": "2024-03-21T07:25:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-03-21T07:25:00Z", "window_start": "2024-03-21T05:30:00Z", "probability": 80, "weather_concerns": "Ground Winds", "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "RL", "description": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": "2006", "launchers": "Electron", "spacecraft": "", "launch_library_url": null, "total_launch_count": 63, "consecutive_successful_launches": 22, "successful_launches": 59, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "info_url": "http://www.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg" }, "rocket": { "id": 8204, "configuration": { "id": 26, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/26/?format=api", "name": "Electron", "active": true, "reusable": false, "description": "Electron is a two-stage orbital expendable launch vehicle (with an optional third stage) developed by the American aerospace company Rocket Lab. Electron is a small-lift launch vehicle designed to launch small satellites and cubesats to sun-synchronous orbit and low earth orbit. The Electron is the first orbital class rocket to use electric-pump-fed engines, powered by the 9 Rutherford engines on the first stage. It is also used as a suborbital testbed (called HASTE) for hypersonics research.", "family": "", "full_name": "Electron", "manufacturer": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "RL", "description": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": "2006", "launchers": "Electron", "spacecraft": "", "launch_library_url": null, "total_launch_count": 63, "consecutive_successful_launches": 22, "successful_launches": 59, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "info_url": "http://www.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 18.0, "diameter": 1.2, "maiden_flight": "2017-05-25", "launch_cost": "6000000", "launch_mass": 13, "leo_capacity": 300, "gto_capacity": null, "to_thrust": 162, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg", "info_url": "https://www.rocketlabusa.com/electron/", "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Electron", "total_launch_count": 63, "consecutive_successful_launches": 22, "successful_launches": 59, "failed_launches": 4, "pending_launches": 31, "attempted_landings": 9, "successful_landings": 7, "failed_landings": 2, "consecutive_successful_landings": 4 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6775, "name": "Live and Let Fly (NROL-123)", "description": "Mission for the National Reconnaissance Office.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "NRO", "description": "The National Reconnaissance Office (NRO) is a member of the United States Intelligence Community and an agency of the United States Department of Defense which designs, builds, launches, and operates the reconnaissance satellites of the U.S. federal government, and provides satellite intelligence to several government agencies, particularly signals intelligence (SIGINT) to the NSA, imagery intelligence (IMINT) to the NGA, and measurement and signature intelligence (MASINT) to the DIA.", "administrator": "Director: Christopher Scolese", "founding_year": "1961", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nro.gov/", "wiki_url": "https://en.wikipedia.org/wiki/National_Reconnaissance_Office", "logo_url": null, "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520reconnaissance2520office_nation_20240228092125.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 79, "url": "https://ll.thespacedevs.com/2.2.0/pad/79/?format=api", "agency_id": 147, "name": "Rocket Lab Launch Complex 2 (Launch Area 0 C)", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=37.833262,-75.488235", "latitude": "37.833262", "longitude": "-75.488235", "location": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/location/21/?format=api", "name": "Wallops Flight Facility, Virginia, USA", "country_code": "USA", "description": "Wallops Flight Facility is a rocket launch site on Wallops Island on the Eastern Shore of Virginia, United States, just east of the Delmarva Peninsula and north-northeast of Norfolk. The facility is operated by the Goddard Space Flight Center in Greenbelt, Maryland, and primarily serves to support science and exploration missions for NASA and other federal agencies. WFF includes an extensively instrumented range to support launches of more than a dozen types of sounding rockets; small expendable suborbital and orbital rockets; high-altitude balloon flights carrying scientific instruments for atmospheric and astronomical research; and, using its Research Airport, flight tests of aeronautical research aircraft, including uncrewed aerial vehicles.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_21_20200803142423.jpg", "timezone_name": "America/New_York", "total_launch_count": 80, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_79_20200803143607.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 3 }, "infoURLs": [ { "priority": 10, "source": "www.rocketlabusa.com", "title": "", "description": "", "feature_image": null, "url": "https://www.rocketlabusa.com/assets/Uploads/Live-Let-Fly-Press-Kit.pdf", "type": { "id": 2, "name": "Official Press Kit" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "Rocket Lab", "title": "Rocket Lab - 'Live And Let Fly' Launch", "description": "", "feature_image": "https://i.ytimg.com/vi/Coa3GZtotQo/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=Coa3GZtotQo", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-03-21T06:10:48Z", "end_time": "2024-03-21T07:36:44Z" } ], "webcast_live": false, "timeline": [ { "type": { "id": 6, "abbrev": "Startup", "description": "The onboard computer takes control over the countdown and runs last checks" }, "relative_time": "-PT2M" }, { "type": { "id": 9, "abbrev": "Ignition", "description": "Start of the engine ignition sequence" }, "relative_time": "-PT2S" }, { "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": "PT58S" }, { "type": { "id": 11, "abbrev": "Max-Q", "description": "Maximum dynamic pressure" }, "relative_time": "PT1M10S" }, { "type": { "id": 12, "abbrev": "MECO", "description": "Cut-off of the main engine" }, "relative_time": "PT2M25S" }, { "type": { "id": 13, "abbrev": "Stage 2 Separation", "description": "Separation of the second stage from the first" }, "relative_time": "PT2M28S" }, { "type": { "id": 31, "abbrev": "SES", "description": "Start of the second engine" }, "relative_time": "PT2M32S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT3M35S" }, { "type": { "id": 72, "abbrev": "Battery Hotswap", "description": "Electron Second stages switches to a new set of batteries and jettisons the depleted ones." }, "relative_time": "PT6M23S" }, { "type": { "id": 24, "abbrev": "SECO", "description": "Cut-off of the second engine" }, "relative_time": "PT9M8S" }, { "type": { "id": 30, "abbrev": "Kick Stage Separation", "description": "Separation of the kick stage from the previous stage" }, "relative_time": "PT9M12S" }, { "type": { "id": 73, "abbrev": "Kick Stage Burn", "description": "The kick stage conducts an engine burn in orbit." }, "relative_time": "PT54M20S" }, { "type": { "id": 35, "abbrev": "Payload Separation", "description": "Final deployment of the payload from the rocket" }, "relative_time": "PT1H" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_liftof_image_20240322071200.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6643, "location_launch_attempt_count": 78, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 46, "orbital_launch_attempt_count_year": 54, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P277DT6H1M", "mission_patches": [ { "id": 992, "name": "Live & Let Fly", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/live25202526_mission_patch_20240312181012.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } } ], "type": "detailed" }
