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/7975274c-81c5-48a5-82e1-9b8d982cd533/?format=api
{ "id": "7975274c-81c5-48a5-82e1-9b8d982cd533", "url": "https://ll.thespacedevs.com/2.2.0/launch/7975274c-81c5-48a5-82e1-9b8d982cd533/?format=api", "slug": "electron-we-love-the-nightlife-capella-acadia-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | We Love the Nightlife (Capella Acadia 1)", "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-05T18:16:14Z", "updates": [ { "id": 4977, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch success", "info_url": "https://twitter.com/RocketLab/status/1694511160723390782", "created_by": "SwGustav", "created_on": "2023-08-24T01:03:40Z" }, { "id": 4976, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=-k2RZO9ghnc", "created_by": "SwGustav", "created_on": "2023-08-23T23:45:56Z" }, { "id": 4975, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Livestream has started", "info_url": "https://www.youtube.com/watch?v=-k2RZO9ghnc", "created_by": "LL2", "created_on": "2023-08-23T23:27:07Z" }, { "id": 4970, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New NET T-0, 23:45 UTC.", "info_url": "https://twitter.com/rocketlab/status/1694273574029422886", "created_by": "Cosmic_Penguin", "created_on": "2023-08-23T08:19:54Z" }, { "id": 4863, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date and time.", "info_url": "https://www.rocketlabusa.com/assets/Uploads/We-Love-The-Nightlife-Press-Kit3...pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-08-14T23:13:04Z" }, { "id": 4781, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rocket engine sensor problem requires roll-back to HIF for investigation.", "info_url": "https://twitter.com/Peter_J_Beck/status/1688083557561077761", "created_by": "Cosmic_Penguin", "created_on": "2023-08-06T07:21:53Z" }, { "id": 4780, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Standing down from today’s launch attempt.", "info_url": "https://twitter.com/rocketlab/status/1688048244558123008", "created_by": "Cosmic_Penguin", "created_on": "2023-08-06T04:45:42Z" }, { "id": 4765, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://twitter.com/RocketLab/status/1687305056625086464", "created_by": "Cosmic_Penguin", "created_on": "2023-08-04T04:50:32Z" }, { "id": 4748, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET August 6 due to launch site winds.", "info_url": "https://twitter.com/rocketlab/status/1686902598593544194", "created_by": "Cosmic_Penguin", "created_on": "2023-08-03T03:08:22Z" }, { "id": 4735, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET August 4 due to weather.", "info_url": "https://twitter.com/rocketlab/status/1685866058518044672", "created_by": "Cosmic_Penguin", "created_on": "2023-07-31T04:18:17Z" }, { "id": 4733, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added new tentative launch time.", "info_url": "https://www.rocketlabusa.com/missions/next-mission/", "created_by": "Cosmic_Penguin", "created_on": "2023-07-31T02:56:06Z" }, { "id": 4731, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Next launch date TBD depending on weather.", "info_url": "https://twitter.com/RocketLab/status/1685558491900190721", "created_by": "Cosmic_Penguin", "created_on": "2023-07-30T07:52:57Z" }, { "id": 4730, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Scrubbed for the day.", "info_url": "https://www.youtube.com/watch?v=IAwEeNI_D10", "created_by": "Cosmic_Penguin", "created_on": "2023-07-30T07:03:10Z" }, { "id": 4729, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Abort.", "info_url": "https://www.youtube.com/watch?v=IAwEeNI_D10", "created_by": "Cosmic_Penguin", "created_on": "2023-07-30T07:01:07Z" }, { "id": 4728, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Livestream has started", "info_url": "https://www.youtube.com/watch?v=IAwEeNI_D10", "created_by": "LL2", "created_on": "2023-07-30T06:33:18Z" }, { "id": 4683, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July 30 due to weather.", "info_url": "https://twitter.com/RocketLab/status/1684058155100291074", "created_by": "Cosmic_Penguin", "created_on": "2023-07-26T04:48:38Z" }, { "id": 4670, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked launch window and pad.", "info_url": "https://www.rocketlabusa.com/assets/Uploads/We-Love-The-Nightlife-Press-Kit...pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-07-25T02:25:02Z" }, { "id": 4661, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Go for launch.", "info_url": "https://twitter.com/RocketLab/status/1683301268729790464", "created_by": "Cosmic_Penguin", "created_on": "2023-07-24T02:23:10Z" }, { "id": 4636, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July 28 UTC.", "info_url": "https://twitter.com/rocketlab/status/1682126380488888321", "created_by": "Cosmic_Penguin", "created_on": "2023-07-21T02:37:14Z" }, { "id": 3424, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET H2 2023", "info_url": "https://www.rocketlabusa.com/updates/rocket-lab-signs-multi-launch-deal-to-deploy-satellite-constellation-for-capella-space/", "created_by": "Nosu", "created_on": "2023-03-01T08:11:28Z" }, { "id": 4727, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New T-0.", "info_url": "https://twitter.com/RocketLab/status/1685509405453041664", "created_by": "Cosmic_Penguin", "created_on": "2023-07-30T04:36:23Z" } ], "net": "2023-08-23T23:45:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2023-08-24T03:30:00Z", "window_start": "2023-08-23T23:30:00Z", "probability": null, "weather_concerns": null, "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": 7795, "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": [ { "id": 439, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 130, "url": "https://ll.thespacedevs.com/2.2.0/launcher/130/?format=api", "details": "40th Electron launch vehicle flown on 'We Love the Nightlife'.", "flight_proven": true, "serial_number": "40", "status": "retired", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/130_image_20230824080859.jpeg", "successful_landings": 1, "attempted_landings": 1, "flights": 1, "last_launch_date": "2023-08-23T23:45:00Z", "first_launch_date": "2023-08-23T23:45:00Z" }, "landing": { "id": 1232, "attempt": true, "success": true, "description": "The Electron booster was successfully recovered after a soft parachute splashdown in the Pacific Ocean.", "downrange_distance": null, "location": { "id": 18, "name": "Pacific Ocean", "abbrev": "PAC", "description": "Pacific Ocean", "location": null, "successful_landings": 46 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 6313, "name": "We Love the Nightlife (Capella Acadia 1)", "description": "Payload consists of a single SAR Earth-imaging Acadia satellite, a new generation satellite designed, manufactured, and operated by Capella Space.\r\n\r\nFirst mission to fly with a reused engine.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 1059, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1059/?format=api", "name": "Capella Space", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "", "description": "Capella Space is an American space company. It is developing space-based radar Earth observation satellites equipped with synthetic-aperture radar that can penetrate clouds and work at night.", "administrator": "CEO: Payam Banazadeh", "founding_year": "2016", "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://capellaspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Capella_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/capella2520space_logo_20230806180121.png", "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 185, "url": "https://ll.thespacedevs.com/2.2.0/pad/185/?format=api", "agency_id": 147, "name": "Rocket Lab Launch Complex 1B", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Launch_Complex_1", "map_url": "https://www.google.com/maps?q=-39.262833,177.864469", "latitude": "-39.262833", "longitude": "177.864469", "location": { "id": 10, "url": "https://ll.thespacedevs.com/2.2.0/location/10/?format=api", "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand", "country_code": "NZL", "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg", "timezone_name": "Pacific/Auckland", "total_launch_count": 57, "total_landing_count": 17 }, "country_code": "NZL", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_185_20200803143540.jpg", "total_launch_count": 28, "orbital_launch_attempt_count": 28 }, "infoURLs": [ { "priority": 10, "source": null, "title": "", "description": "", "feature_image": null, "url": "https://www.rocketlabusa.com/assets/Uploads/We-Love-The-Nightlife-Press-Kit...pdf", "type": null, "language": null } ], "vidURLs": [ { "priority": 9, "source": null, "publisher": null, "title": "Rocket Lab 'We Love The Nightlife' Launch", "description": "", "feature_image": "https://i.ytimg.com/vi/-k2RZO9ghnc/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=-k2RZO9ghnc", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "SCRUBBED | Rocket Lab 'We Love The Nightlife' Launch", "description": "", "feature_image": "https://i.ytimg.com/vi/IAwEeNI_D10/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=IAwEeNI_D10", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron25202_image_20230824082352.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6501, "location_launch_attempt_count": 37, "pad_launch_attempt_count": 11, "agency_launch_attempt_count": 40, "orbital_launch_attempt_count_year": 133, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P36DT22H18M", "mission_patches": [ { "id": 846, "name": "We love the nightlife", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/we2520love252_mission_patch_20230722134502.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } } ], "type": "detailed" }
