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/3985e602-f22f-441f-a0b1-a450ea459da9/?format=api
{ "id": "3985e602-f22f-441f-a0b1-a450ea459da9", "url": "https://ll.thespacedevs.com/2.2.0/launch/3985e602-f22f-441f-a0b1-a450ea459da9/?format=api", "slug": "electron-love-at-first-insight-blacksky-10-11", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | Love At First Insight (BlackSky 10-11)", "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-08-02T12:36:07Z", "updates": [ { "id": 990, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/scottm3_profile_20210817212204.png", "comment": "Payload successfully deployed via rocket lab twitter.", "info_url": "https://twitter.com/RocketLab/status/1461161195088474115", "created_by": "scottm3", "created_on": "2021-11-18T02:41:07Z" }, { "id": 989, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adjusting T-0 and setting GO", "info_url": "https://twitter.com/RocketLab/status/1461049683254525952", "created_by": "Nosu", "created_on": "2021-11-17T19:18:38Z" }, { "id": 978, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Delayed once again due to weather.", "info_url": "https://twitter.com/RocketLab/status/1460507497190412292", "created_by": "spacevogel", "created_on": "2021-11-16T07:24:30Z" }, { "id": 977, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Launch delayed due to weather.", "info_url": "https://twitter.com/RocketLab/status/1459969141956247556", "created_by": "spacevogel", "created_on": "2021-11-14T20:29:05Z" }, { "id": 967, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch scrubbed due to an out-of-family ground sensor reading and to allow more time to complete helicopter recovery preparations. Launch window for November 16 can be found in mission kit.", "info_url": "https://twitter.com/rocketlab/status/1458646267790168067?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-11-11T04:12:07Z" }, { "id": 964, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch time.", "info_url": "https://twitter.com/rocketlab/status/1458598728395202561?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-11-11T01:43:35Z" }, { "id": 963, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Updating T-0", "info_url": "https://twitter.com/RocketLab/status/1458598728395202561", "created_by": "Nosu", "created_on": "2021-11-11T01:43:03Z" }, { "id": 957, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Go for launch after WDR.", "info_url": "https://twitter.com/rocketlab/status/1457886660004245507?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-11-09T02:35:45Z" }, { "id": 906, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch time", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2021-10-23T22:12:11Z" }, { "id": 718, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "http://spaceref.com/news/viewpr.html?pid=57946", "created_by": "Nosu", "created_on": "2021-08-10T14:13:07Z" }, { "id": 862, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New NET launch date.", "info_url": "https://twitter.com/rocketlab/status/1447503560497762310", "created_by": "Cosmic_Penguin", "created_on": "2021-10-11T10:49:18Z" } ], "net": "2021-11-18T01:38:13Z", "net_precision": null, "window_end": "2021-11-18T03:30:00Z", "window_start": "2021-11-18T01:20: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": 71, "consecutive_successful_launches": 30, "successful_launches": 67, "failed_launches": 4, "pending_launches": 31, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "info_url": "https://rocketlabcorp.com", "wiki_url": "https://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": 2993, "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": 71, "consecutive_successful_launches": 30, "successful_launches": 67, "failed_launches": 4, "pending_launches": 31, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "info_url": "https://rocketlabcorp.com", "wiki_url": "https://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": 71, "consecutive_successful_launches": 30, "successful_launches": 67, "failed_launches": 4, "pending_launches": 29, "attempted_landings": 9, "successful_landings": 7, "failed_landings": 2, "consecutive_successful_landings": 4 }, "launcher_stage": [ { "id": 196, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 104, "url": "https://ll.thespacedevs.com/2.2.0/launcher/104/?format=api", "details": "Booster used for Electron's 22nd flight (Love At First Insight)", "flight_proven": true, "serial_number": "22", "status": "retired", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20211109093154.jpg", "successful_landings": 1, "attempted_landings": 1, "flights": 1, "last_launch_date": "2021-11-18T01:38:13Z", "first_launch_date": "2021-11-18T01:38:13Z" }, "landing": { "id": 223, "attempt": true, "success": true, "description": "Electron's first stage splashed down in the pacific ocean following main chute deployment.", "downrange_distance": null, "location": { "id": 15, "name": "South Pacific", "abbrev": "PAC", "description": "Pacific Ocean off the coast of Mahia Peninsula, New Zealand.", "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": 64, "total_landing_count": 17 }, "successful_landings": 4 }, "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": 1418, "name": "Love At First Insight (BlackSky 10-11)", "description": "Payload consists of two BlackSky Gen-2 high-resolution multi-spectral Earth observation satellites.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 65, "url": "https://ll.thespacedevs.com/2.2.0/pad/65/?format=api", "agency_id": 147, "name": "Rocket Lab Launch Complex 1A", "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": 64, "total_landing_count": 17 }, "country_code": "NZL", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_65_20200803143549.jpg", "total_launch_count": 33, "orbital_launch_attempt_count": 33 }, "infoURLs": [ { "priority": 9, "source": null, "title": "Love At First Insight", "description": "Scheduled to lift-off from Launch Complex 1 on New Zealand’s Mahia Peninsula in late August, the ‘Love At First Insight’ mission will be Rocket Lab’s 22nd Electron launch overall and fifth mission of 2021. ‘Love At First Insight’ is the first in a rapid succession of scheduled Electron launches betw...", "feature_image": null, "url": "https://www.rocketlabusa.com/missions/completed-missions/love-at-first-insight/", "type": null, "language": null }, { "priority": 10, "source": null, "title": "", "description": "", "feature_image": null, "url": "https://www.rocketlabusa.com/assets/Uploads/Rocket-Lab-F22-Love-At-First-Insight-Press-Kit.pdf", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": "youtube.com", "publisher": "The Space Devs", "title": "Electron Love at First Insight", "description": "Electron Love at First Insight with initial coverage and post coverage cut\nThumbnail Photo Credit: Rocket Lab", "feature_image": "https://i.ytimg.com/vi/pEIJKuDio8I/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=pEIJKuDio8I", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2021-11-18T04:37:21Z", "end_time": "2021-11-18T04:49:56Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Rocket Lab", "title": "Rocket Lab - Love At First Insight Launch 11/18/2021", "description": "'Love At First Insight' was a dedicated mission for BlackSky Inc.\nThe mission lifted off from pad A at Rocket Lab's Launch Complex 1 at 01:38 UTC on November 18 2021.\nThe mission was also Rocket Lab’s...", "feature_image": "https://i.ytimg.com/vi/N-sVCWo_xpE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=N-sVCWo_xpE", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2021-11-18T01:10:03Z", "end_time": "2021-11-18T02:36:39Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6151, "location_launch_attempt_count": 22, "pad_launch_attempt_count": 22, "agency_launch_attempt_count": 22, "orbital_launch_attempt_count_year": 114, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P111DT19H38M13S", "mission_patches": [ { "id": 75, "name": "Love At First Insight Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/love2520at252_mission_patch_20210817081559.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } } ], "type": "detailed" }
