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/5e915de9-f574-433b-bf39-d90b616c0e8b/?format=api
{ "id": "5e915de9-f574-433b-bf39-d90b616c0e8b", "url": "https://ll.thespacedevs.com/2.2.0/launch/5e915de9-f574-433b-bf39-d90b616c0e8b/?format=api", "slug": "electron-there-and-back-again-rideshare", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | There and Back Again (Rideshare)", "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-01T16:54:39Z", "updates": [ { "id": 1641, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "All payloads deployed successfully", "info_url": "https://twitter.com/RocketLab/status/1521278315088138244", "created_by": "Jay", "created_on": "2022-05-03T00:11:28Z" }, { "id": 1640, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Liftoff", "info_url": null, "created_by": "Jay", "created_on": "2022-05-02T22:50:28Z" }, { "id": 1638, "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/1521212686280790016", "created_by": "Nosu", "created_on": "2022-05-02T19:45:46Z" }, { "id": 1635, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Delayed by another day due to weather", "info_url": "https://twitter.com/RocketLab/status/1520496945420111872", "created_by": "SwGustav", "created_on": "2022-04-30T21:37:41Z" }, { "id": 1628, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Delayed to May 1st UTC due to weather", "info_url": "https://twitter.com/RocketLab/status/1520108432753184768", "created_by": "Jay", "created_on": "2022-04-29T18:44:17Z" }, { "id": 1614, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Launch delayed to April 29 UTC due to unfavourable recovery weather.", "info_url": "https://twitter.com/RocketLab/status/1519433085284089856", "created_by": "Jay", "created_on": "2022-04-27T22:00:26Z" }, { "id": 1607, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date", "info_url": "https://twitter.com/RocketLab/status/1518747296829116417", "created_by": "Cosmic_Penguin", "created_on": "2022-04-26T00:32:12Z" }, { "id": 1600, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch window", "info_url": "https://www.rocketlabusa.com/missions/next-mission/", "created_by": "Cosmic_Penguin", "created_on": "2022-04-24T03:58:13Z" }, { "id": 1591, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/scottm3_profile_20210817212204.png", "comment": "Launch date pushed to 27th April UTC due to unfavorable recovery weather.", "info_url": "https://twitter.com/RocketLab/status/1517328086345281536", "created_by": "scottm3", "created_on": "2022-04-22T03:34:19Z" }, { "id": 1589, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET April 23 UTC", "info_url": "https://www.rocketlabusa.com/missions/next-mission/", "created_by": "Cosmic_Penguin", "created_on": "2022-04-21T18:52:31Z" }, { "id": 1561, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date", "info_url": "https://twitter.com/RocketLab/status/1514374490825756672", "created_by": "Cosmic_Penguin", "created_on": "2022-04-13T23:58:14Z" }, { "id": 1560, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch window confirmed.", "info_url": "https://www.rocketlabusa.com/assets/Uploads/There-and-Back-Again-Press-Kit.pdf", "created_by": "Cosmic_Penguin", "created_on": "2022-04-13T17:59:17Z" }, { "id": 1536, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET April 19", "info_url": "https://www.businesswire.com/news/home/20220405005568/en/Rocket-Lab-to-Attempt-First-Mid-Air-Helicopter-Capture-of-the-Electron-Rocket-During-Next-Mission", "created_by": "Nosu", "created_on": "2022-04-05T19:49:19Z" } ], "net": "2022-05-02T22:49:52Z", "net_precision": null, "window_end": "2022-05-03T00:40:00Z", "window_start": "2022-05-02T22:35: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": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "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": 7560, "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": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "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": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "failed_launches": 4, "pending_launches": 31, "attempted_landings": 9, "successful_landings": 7, "failed_landings": 2, "consecutive_successful_landings": 4 }, "launcher_stage": [ { "id": 226, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 110, "url": "https://ll.thespacedevs.com/2.2.0/launcher/110/?format=api", "details": "First stage used for Electron's 26th flight (There and Back Again).", "flight_proven": true, "serial_number": "26", "status": "retired", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/110_image_20220420085303.jpg", "successful_landings": 0, "attempted_landings": 1, "flights": 1, "last_launch_date": "2022-05-02T22:49:52Z", "first_launch_date": "2022-05-02T22:49:52Z" }, "landing": { "id": 251, "attempt": true, "success": false, "description": "Rocket lab successfully caught the Electron first stage, however due to different load characteristics than were experienced during testing the pilot dropped the stage at his discretion to complete a successful splashdown.", "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": 58, "total_landing_count": 17 }, "successful_landings": 4 }, "type": { "id": 5, "name": "Helicopter Catch", "abbrev": "HC", "description": "The first stage is caught by a helicopter while slowly descending towards the sea under a parachute." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 5985, "name": "There and Back Again (Rideshare)", "description": "Commercial rideshare mission including payloads for Alba Orbital, Astrix Astronautics, Aurora Propulsion Technologies, E-Space, Spaceflight Inc, Swarm Technologies and UNSEENLABS.", "launch_designator": null, "type": "Dedicated Rideshare", "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": 58, "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": 30, "orbital_launch_attempt_count": 30 }, "infoURLs": [ { "priority": 10, "source": null, "title": "There And Back Again", "description": "Launching from Pad A at Rocket Lab Launch Complex 1 on New Zealand’s Mahia Peninsula, the “There And Back Again” mission will be Rocket Lab’s 26th Electron launch.", "feature_image": null, "url": "https://www.rocketlabusa.com/missions/completed-missions/there-and-back-again/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Electron There and Back Again", "description": "Electron There and Back Again with initial coverage and post coverage cutThumbnail Photo Credit: RocketLab", "feature_image": "https://i.ytimg.com/vi/K7vb5btFqy4/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=K7vb5btFqy4", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Rocket Lab - 'There And Back Again' Launch", "description": "The “There And Back Again” mission will see Electron deploy 34 satellites to a sun synchronous orbit for a variety of customers including Alba Orbital, Astri...", "feature_image": "https://i.ytimg.com/vi/6nODVPGHQcc/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=6nODVPGHQcc", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron25202_image_20220420085230.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6230, "location_launch_attempt_count": 26, "pad_launch_attempt_count": 25, "agency_launch_attempt_count": 26, "orbital_launch_attempt_count_year": 48, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P30DT10H8M14S", "mission_patches": [ { "id": 627, "name": "There And Back Again Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/there2520and2_mission_patch_20220407141220.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } } ], "type": "detailed" }
