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/dff2b6dc-933a-42b4-8d74-db543ada94bb/?format=api
{ "id": "dff2b6dc-933a-42b4-8d74-db543ada94bb", "url": "https://ll.thespacedevs.com/2.2.0/launch/dff2b6dc-933a-42b4-8d74-db543ada94bb/?format=api", "slug": "electron-they-go-up-so-fast-rideshare", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | They Go Up So Fast (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-02T12:31:10Z", "updates": [ { "id": 404, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Success confirmed", "info_url": "https://twitter.com/RocketLab/status/1374161534352433153", "created_by": "SwGustav", "created_on": "2021-03-23T00:52:42Z" }, { "id": 403, "profile_image": null, "comment": "First five payloads successfully deployed per live webcast. One more burn before the final payload - about forty minutes from now.", "info_url": null, "created_by": "spacelaunchnowadmin", "created_on": "2021-03-22T23:27:55Z" }, { "id": 402, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adjusting T-0", "info_url": "https://twitter.com/RocketLab/status/1374043938231873539", "created_by": "Nosu", "created_on": "2021-03-22T17:13:16Z" }, { "id": 398, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch is GO. Window opens on March 22 at 22:20 UTC.", "info_url": "https://twitter.com/RocketLab/status/1373698430887895043?s=20", "created_by": "Nosu", "created_on": "2021-03-21T18:18:07Z" }, { "id": 360, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch expected on March 22. Precise T-0 not available yet.", "info_url": "https://twitter.com/NotamUpdates/status/1372445536758927360?s=20", "created_by": "Nosu", "created_on": "2021-03-18T14:35:09Z" }, { "id": 273, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Adding the launch", "info_url": "https://twitter.com/RocketLab/status/1359189648052875266", "created_by": "SwGustav", "created_on": "2021-02-10T08:12:16Z" } ], "net": "2021-03-22T22:30:00Z", "net_precision": null, "window_end": "2021-03-23T00:05:00Z", "window_start": "2021-03-22T21:50: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": 2829, "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": [], "spacecraft_stage": null }, "mission": { "id": 1242, "name": "They Go Up So Fast (Rideshare)", "description": "The Electron rocket will carry seven satellites to low Earth orbit: one Earth-observation satellite for BlackSky, two Internet-Of-Things (IoT) nanosatellites for companies Fleet Space and Myriota, a technology demonstration satellite for the University of New South Wales (UNSW) Canberra Space, a weather satellite pathfinder technology demonstration from Care Weather technologies, a technology demonstrator for the U.S. Army’s Space and Missile Defense Command as well as Rocket Lab’s in-house designed and built Photon Pathstone spacecraft which will operate on orbit as a risk reduction demonstration to build spacecraft heritage ahead of Rocket Lab’s mission to the Moon for NASA later this year.", "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": "They Go Up So Fast", "description": "Rocket Lab's 19th Electron mission will deploy a range of satellites for commercial and government satellite operators, as well as place a next-generation Rocket Lab Photon spacecraft in orbit to build spacecraft heritage ahead of Rocket Lab’s mission to the Moon for NASA later this year.", "feature_image": null, "url": "https://www.rocketlabusa.com/missions/completed-missions/they-go-up-so-fast/", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Rocket Lab 'They Go Up So Fast' Launch", "description": "Lift-off of the 'Another One Leaves The Crust' mission for OHB Group occurred at 07:26 UTC on January 20 2021 from Pad A at Rocket Lab Launch Complex 1 on Ne...", "feature_image": "https://i.ytimg.com/vi/u5wmrGriVX0/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=u5wmrGriVX0", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/electron25202_infographic_20210322171824.jpeg", "program": [], "orbital_launch_attempt_count": 6061, "location_launch_attempt_count": 19, "pad_launch_attempt_count": 19, "agency_launch_attempt_count": 19, "orbital_launch_attempt_count_year": 24, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P61DT15H4M", "mission_patches": [ { "id": 438, "name": "They Go Up So Fast Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/they2520go252_mission_patch_20211031044036.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } } ], "type": "detailed" }
