Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f/?format=api
{ "id": "c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f", "url": "https://lldev.thespacedevs.com/2.0.0/launch/c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f/?format=api", "launch_library_id": null, "slug": "falcon-heavy-dragonfly", "name": "Falcon Heavy | Dragonfly", "status": { "id": 2, "name": "TBD" }, "net": "2028-07-05T00:00:00Z", "window_end": "2028-07-05T00:00:00Z", "window_start": "2028-07-05T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 745, "consecutive_successful_launches": 230, "successful_launches": 730, "failed_launches": 15, "pending_launches": 136, "consecutive_successful_landings": 39, "successful_landings": 690, "failed_landings": 29, "attempted_landings": 718, "info_url": "https://www.spacex.com/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg" }, "rocket": { "id": 8423, "configuration": { "id": 161, "launch_library_id": 58, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/161/?format=api", "name": "Falcon Heavy", "description": "The Falcon Heavy is a variant of the Falcon 9 full thrust launch vehicle and consists of a standard Falcon 9 rocket core, with two additional boosters derived from the Falcon 9 first stage.", "family": "Falcon", "full_name": "Falcon Heavy", "manufacturer": { "id": 121, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 745, "consecutive_successful_launches": 230, "successful_launches": 730, "failed_launches": 15, "pending_launches": 136, "consecutive_successful_landings": 39, "successful_landings": 690, "failed_landings": 29, "attempted_landings": 718, "info_url": "https://www.spacex.com/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg" }, "program": [], "variant": "Heavy", "alias": "", "min_stage": 3, "max_stage": 3, "length": 70.0, "diameter": 12.2, "maiden_flight": "2018-02-06", "launch_mass": 1400, "leo_capacity": 63800, "gto_capacity": 26700, "to_thrust": 22819, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_image_20220129192819.jpeg", "info_url": "https://www.spacex.com/vehicles/falcon-heavy/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Falcon_Heavy", "total_launch_count": 14, "consecutive_successful_launches": 14, "successful_launches": 14, "failed_launches": 0, "pending_launches": 12 }, "launcher_stage": [ { "id": 627, "type": "Core", "reused": null, "launcher_flight_number": null, "launcher": { "id": 117, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/117_image_20230723180948.png", "successful_landings": null, "attempted_landings": null, "flights": null, "last_launch_date": null, "first_launch_date": null }, "landing": null, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null }, { "id": 628, "type": "Strap-On Booster", "reused": null, "launcher_flight_number": null, "launcher": { "id": 117, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/117_image_20230723180948.png", "successful_landings": null, "attempted_landings": null, "flights": null, "last_launch_date": null, "first_launch_date": null }, "landing": null, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null }, { "id": 629, "type": "Strap-On Booster", "reused": null, "launcher_flight_number": null, "launcher": { "id": 117, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/117_image_20230723180948.png", "successful_landings": null, "attempted_landings": null, "flights": null, "last_launch_date": null, "first_launch_date": null }, "landing": null, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 7012, "launch_library_id": null, "name": "Dragonfly", "description": "Dragonfly is NASA's 4th New Frontiers program mission that will send a robotic rotorcraft to fly within the atmosphere of Saturn's moon Titan to sample materials and determine surface composition in different geologic settings, advancing humanity's search for the building blocks of life.\r\n\r\nThe craft is a large quadcopter with double rotors with mass of about 875 kg, featuring rotors of 1.35 m in diameter. It can fly through several kilometers within an hour and will perform 1 flight per Titan day (~16 Earth days). During the planned 3.3-year mission, Dragonfly is expected to cover distance up to several hundred km.\r\n\r\nDragonfly will use a Multi-Mission Radioisotope Thermoelectric Generator (MMRTG) to power its instruments.\r\n\r\nThe planned science instrument suite is:\r\n* DragonCam: Camera Suite\r\n* DrACO: Drill for Acquisition of Complex Organics\r\n* DraMS: Mass Spectrometer\r\n* DraGNS: Gamma-ray and Neutron Spectrometer\r\n* DraGMet: Geophysics and Meteorology", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" } }, "pad": { "id": 87, "url": "https://lldev.thespacedevs.com/2.0.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kennedy_Space_Center_Launch_Complex_39#Launch_Pad_39A", "map_url": "https://www.google.com/maps?q=28.60822681,-80.60428186", "latitude": "28.60822681", "longitude": "-80.60428186", "location": { "id": 27, "url": "https://lldev.thespacedevs.com/2.0.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "total_launch_count": 283, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 224 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_li_image_20241020093505.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7695, "location_launch_attempt_count": 293, "pad_launch_attempt_count": 231, "agency_launch_attempt_count": 850, "orbital_launch_attempt_count_year": 10, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4 }
