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/63b7d43c-2711-4191-aa1e-344f9339ff34/?format=api
{ "id": "63b7d43c-2711-4191-aa1e-344f9339ff34", "url": "https://ll.thespacedevs.com/2.2.0/launch/63b7d43c-2711-4191-aa1e-344f9339ff34/?format=api", "slug": "minotaur-iv-ews-od-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Minotaur IV | EWS OD-1", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-01-12T11:24:24Z", "updates": [ { "id": 6265, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://www.ssc.spaceforce.mil/LinkClick.aspx?fileticket=-vdVwK15vfM%3d&portalid=3", "created_by": "Cosmic_Penguin", "created_on": "2024-01-12T11:24:24Z" } ], "net": "2025-05-31T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2025-05-31T00:00:00Z", "window_start": "2025-05-31T00: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": 8171, "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": 6738, "name": "EWS OD-1", "description": "The Electro-Optical/Infrared Weather System (EWS) Operational Demonstration-1 (OD-1) is a weather satellite for the United States Space Force. It is a prototype satellite made by General Atomics that will be place in LEO for a three-year demonstration mission of new EO/IR sensor technologies to various US military branches, and to act as a stop-gap for Defense Department needs for weather data.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "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": 806, "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": [], "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": 6966, "location_launch_attempt_count": 809, "pad_launch_attempt_count": 10, "agency_launch_attempt_count": 16, "orbital_launch_attempt_count_year": 117, "location_launch_attempt_count_year": 23, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P44DT4H27M", "mission_patches": [], "type": "detailed" }
