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/18aeb565-fc14-402e-be79-c8b141db209f/?format=api
{ "id": "18aeb565-fc14-402e-be79-c8b141db209f", "url": "https://ll.thespacedevs.com/2.2.0/launch/18aeb565-fc14-402e-be79-c8b141db209f/?format=api", "slug": "minotaur-iv-nrol-174", "flightclub_url": null, "r_spacex_api_id": null, "name": "Minotaur IV | NROL-174", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-04-17T01:33:15Z", "updates": [ { "id": 10744, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch success", "info_url": "https://x.com/NatReconOfc/status/1912614345801941134", "created_by": "SwGustav", "created_on": "2025-04-16T22:24:00Z" }, { "id": 10743, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Apparent liftoff", "info_url": "https://cameras.alertcalifornia.org/?pos=34.6027_-120.5736_10&id=Axis-Dangermond2", "created_by": "SwGustav", "created_on": "2025-04-16T19:48:00Z" }, { "id": 10737, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://x.com/NatReconOfc/status/1911932450315399222", "created_by": "Cosmic_Penguin", "created_on": "2025-04-15T03:59:00Z" }, { "id": 10702, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://www.nro.gov/Launches/launch-nrol-174/", "created_by": "Cosmic_Penguin", "created_on": "2025-04-10T06:22:00Z" }, { "id": 10662, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET April 16.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=54082.msg2678296#msg2678296", "created_by": "Cosmic_Penguin", "created_on": "2025-04-09T17:16:00Z" }, { "id": 6264, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://spaceflightnow.com/2021/06/15/three-nro-satellites-launched-by-minotaur-rocket-with-surplus-missile-parts/", "created_by": "Cosmic_Penguin", "created_on": "2024-01-12T11:17:16Z" } ], "net": "2025-04-16T19:33:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2025-04-16T21:26:00Z", "window_start": "2025-04-16T19:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "NGSS", "description": "Northrup Grumman Space Systems designs, builds and delivers space, defence and aviation-related systems to customers around the world. They aquired Orbital ATK in 2018 along with its launchers and ongoing missions.", "administrator": "CEO: Kathy Warden", "founding_year": "2015", "launchers": "Antares | Minotaur | Pegasus", "spacecraft": "Cygnus", "launch_library_url": null, "total_launch_count": 15, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 0, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.northropgrumman.com/AboutUs/BusinessSectors/InnovationSystems/Pages/default.aspx", "wiki_url": "https://en.wikipedia.org/wiki/Northrop_Grumman#Innovation_Systems", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_logo_20190207032451.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_image_20190207032451.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520space2520systems_nation_20230624130158.jpg" }, "rocket": { "id": 8170, "configuration": { "id": 52, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/52/?format=api", "name": "Minotaur IV", "active": true, "reusable": false, "description": "The Minotaur IV launch system is derived from the Peacekeeper ICBM. The first three stages are taken directly from decommissioned Peacekeeper missiles. A fourth stage, the Orion-38, is taken from the Pegasus family of air-launched rockets.", "family": "Minotaur", "full_name": "Minotaur IV", "manufacturer": { "id": 179, "url": "https://ll.thespacedevs.com/2.2.0/agencies/179/?format=api", "name": "Orbital ATK", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "OA", "description": "Orbital ATK Inc. was an American aerospace manufacturer and defense industry company. It was formed in 2015 from the merger of Orbital Sciences Corporation and parts of Alliant Techsystems. Orbital ATK was purchased by Northrop Grumman in 2018.", "administrator": "President: David W. Thompson", "founding_year": "2015", "launchers": "Antares | Minotaur | Pegasus", "spacecraft": "", "launch_library_url": null, "total_launch_count": 6, "consecutive_successful_launches": 6, "successful_launches": 6, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.orbitalatk.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orbital_ATK", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital2520atk_logo_20190207032453.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital2520atk_image_20190207032453.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital2520atk_nation_20190207032453.jpeg" }, "program": [], "variant": "", "alias": "Peacekeeper SLV", "min_stage": 4, "max_stage": 4, "length": 23.9, "diameter": 2.35, "maiden_flight": "2010-09-26", "launch_cost": null, "launch_mass": 86, "leo_capacity": 1735, "gto_capacity": 0, "to_thrust": 2200, "apogee": 500, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/minotaur_iv_lau_image_20240307170209.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Minotaur_IV", "total_launch_count": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6737, "name": "NROL-174", "description": "Classified payload for the U.S. National Reconnaissance Office.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" }, "agencies": [ { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "NRO", "description": "The National Reconnaissance Office (NRO) is a member of the United States Intelligence Community and an agency of the United States Department of Defense which designs, builds, launches, and operates the reconnaissance satellites of the U.S. federal government, and provides satellite intelligence to several government agencies, particularly signals intelligence (SIGINT) to the NSA, imagery intelligence (IMINT) to the NGA, and measurement and signature intelligence (MASINT) to the DIA.", "administrator": "Director: Christopher Scolese", "founding_year": "1961", "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://www.nro.gov/", "wiki_url": "https://en.wikipedia.org/wiki/National_Reconnaissance_Office", "logo_url": null, "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520reconnaissance2520office_nation_20240228092125.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/pad/8/?format=api", "agency_id": 161, "name": "Space Launch Complex 8", "description": "Space Launch Complex 8 (SLC-8), is a launch pad at Vandenberg Space Force Base in California, United States. It is used by Minotaur rockets. It was originally part of the California Spaceport, and was known as the Commercial Launch Facility (CLF) or Space Launch Facility (SLF).", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_8", "map_url": "https://www.google.com/maps?q=34.57635,-120.63245", "latitude": "34.57635", "longitude": "-120.63245", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 804, "total_landing_count": 26 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_8_20200803143300.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 9 }, "infoURLs": [ { "priority": 10, "source": "www.nro.gov", "title": "> Launches > launch-nrol-174", "description": "THE NATIONAL RECONNAISSANCE OFFICE (NRO), IN PARTNERSHIP WITH U.S. SPACE FORCE SPACE SYSTEMS COMMAND/ROCKET SYSTEMS LAUNCH PROGRAM, SPACE LAUNCH DELTA 30, AND NORTHROP GRUMMAN, ARE SCHEDULED TO LAUNCH THE NROL-174 MISSION ON April 16, 2025, FROM SPACE LAUNCH COMPLEX-8 AT VANDENBERG SPACE FORCE BASE ...", "feature_image": null, "url": "https://www.nro.gov/Launches/launch-nrol-174/", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/minotaur_iv_lau_image_20240307170209.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6928, "location_launch_attempt_count": 801, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 15, "orbital_launch_attempt_count_year": 79, "location_launch_attempt_count_year": 15, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P5157DT9H23M17S", "mission_patches": [ { "id": 1121, "name": "NROL-174 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-1742520pa_mission_patch_20250410062238.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
