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/4f77007c-9bb3-4bf4-bab3-937e65f75c45/?format=api
{ "id": "4f77007c-9bb3-4bf4-bab3-937e65f75c45", "url": "https://ll.thespacedevs.com/2.2.0/launch/4f77007c-9bb3-4bf4-bab3-937e65f75c45/?format=api", "slug": "electron-coming-to-a-storm-near-you-tropics-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "Electron | Coming To A Storm Near You (TROPICS-3)", "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:23:28Z", "updates": [ { "id": 4158, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Payloads have been deployed.", "info_url": "https://twitter.com/nasa_lsp/status/1661954921292333059", "created_by": "Cosmic_Penguin", "created_on": "2023-05-26T04:42:48Z" }, { "id": 4157, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=rmYmgfMr2a8", "created_by": "Cosmic_Penguin", "created_on": "2023-05-26T03:47:53Z" }, { "id": 4156, "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=rmYmgfMr2a8", "created_by": "LL2", "created_on": "2023-05-26T03:14:45Z" }, { "id": 4155, "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/1661912847478300672", "created_by": "Cosmic_Penguin", "created_on": "2023-05-26T02:01:28Z" }, { "id": 4128, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed 1 day due to upper level winds.", "info_url": "https://twitter.com/rocketlab/status/1661516096023953409", "created_by": "Cosmic_Penguin", "created_on": "2023-05-24T23:37:34Z" }, { "id": 4080, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to May 25 due to weather.", "info_url": "https://twitter.com/rocketlab/status/1660381431070351361", "created_by": "Cosmic_Penguin", "created_on": "2023-05-21T22:38:51Z" }, { "id": 4072, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Delayed a day due to unfavourable weather", "info_url": "https://twitter.com/RocketLab/status/1660025172555100161", "created_by": "Jay", "created_on": "2023-05-20T20:54:01Z" }, { "id": 4045, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Refined launch window.", "info_url": "https://www.rocketlabusa.com/assets/Uploads/TROPICS-PRESS-KIT-F36-F37.pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-05-16T04:59:24Z" }, { "id": 4043, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Updated launch date confirmed by Rocket Lab", "info_url": "https://twitter.com/RocketLab/status/1658215028011728897", "created_by": "Jay", "created_on": "2023-05-15T21:21:43Z" }, { "id": 3943, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed with the other TROPICS launch due to weather conditions, new date TBD.", "info_url": "https://twitter.com/RocketLab/status/1653881060500049921", "created_by": "Cosmic_Penguin", "created_on": "2023-05-04T08:31:08Z" }, { "id": 3774, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "NET May 16th from LC-1B", "info_url": "https://www.rocketlabusa.com/assets/Uploads/FINAL-TROPICS-Press-Kit.pdf", "created_by": "Jay", "created_on": "2023-04-10T21:23:56Z" }, { "id": 2894, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Updating launch vehicle, provider, and pad. Launch NET May 2023.", "info_url": "https://www.nasa.gov/press-release/nasa-awards-launch-services-task-order-for-tropics-cubesats-mission", "created_by": "Nosu", "created_on": "2022-11-23T15:59:44Z" }, { "id": 1453, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch TBD May", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-03-25T21:57:34Z" } ], "net": "2023-05-26T03:46:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2023-05-26T04:40:00Z", "window_start": "2023-05-26T03: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": 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": 7555, "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": 441, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 132, "url": "https://ll.thespacedevs.com/2.2.0/launcher/132/?format=api", "details": "Booster expended on the \"Coming To A Storm Near You\" mission", "flight_proven": true, "serial_number": "37", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20230824175716.jpeg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2023-05-26T03:46:00Z", "first_launch_date": "2023-05-26T03:46:00Z" }, "landing": { "id": 1234, "attempt": false, "success": null, "description": "Booster expended on its first flight.", "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": 8, "name": "Expended", "abbrev": "EXP", "description": "Vehicle did not perform any landing operations after launch" } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 6081, "name": "TROPICS-3", "description": "Last two operational (TROPICS-06 & TROPICS-07) satellites for NASA's Time-Resolved Observations of Precipitation Structure and Storm Intensity with a Constellation of SmallSats (TROPICS) mission.\r\n\r\nThe CubeSats are designed to provide rapid-refresh microwave measurements that can be used to determine temperature, pressure, and humidity inside hurricanes as they form and evolve.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" } ], "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": 58, "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": 9, "source": null, "title": "", "description": "", "feature_image": null, "url": "https://www.rocketlabusa.com/assets/Uploads/FINAL-TROPICS-Press-Kit.pdf", "type": null, "language": null }, { "priority": 9, "source": null, "title": "NASA Awards Launch Services Task Order for TROPICS CubeSats Mission", "description": "NASA has selected Rocket Lab USA Inc. of Long Beach, California, to provide the launch service for the agency’s Time-Resolved Observations of Precipitation Structure and Storm Intensity with a Constellation of Smallsats (TROPICS) mission, as part of the agency's Venture-class Acquisition of Dedicate...", "feature_image": null, "url": "https://www.nasa.gov/press-release/nasa-awards-launch-services-task-order-for-tropics-cubesats-mission", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Launch of Cyclone-Tracking TROPICS CubeSats from New Zealand, Pt. II (Official NASA Broadcast)", "description": "NASA and Rocket Lab will launch two small satellites to join two already in orbit for NASA's TROPICS (Time-Resolved Observations of Precipitation structure a...", "feature_image": "https://i.ytimg.com/vi/rmYmgfMr2a8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=rmYmgfMr2a8", "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_20230719141203.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6446, "location_launch_attempt_count": 35, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 37, "orbital_launch_attempt_count_year": 78, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P18DT2H46M", "mission_patches": [ { "id": 774, "name": "Coming To A Storm Near You Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/coming2520to2_mission_patch_20230421081809.png", "agency": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api", "name": "Rocket Lab", "type": "Commercial" } }, { "id": 635, "name": "Tropics Mission Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/tropics2520mis_mission_patch_20220608183947.png", "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } } ], "type": "detailed" }
