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/c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f/?format=api
{ "id": "c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f", "url": "https://ll.thespacedevs.com/2.2.0/launch/c6e0ad16-8a78-46bc-a693-fbbf5ea4db6f/?format=api", "slug": "falcon-heavy-dragonfly", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon Heavy | Dragonfly", "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-11-26T02:46:33Z", "updates": [ { "id": 9321, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://www.nasa.gov/news-release/nasa-awards-launch-services-contract-for-dragonfly-mission/", "created_by": "Cosmic_Penguin", "created_on": "2024-11-26T02:46:00Z" } ], "net": "2028-07-05T00:00:00Z", "net_precision": { "id": 5, "name": "Day", "abbrev": "DAY", "description": "The T-0 is expected on the given day." }, "window_end": "2028-07-05T00:00:00Z", "window_start": "2028-07-05T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.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": 504, "consecutive_successful_launches": 27, "successful_launches": 490, "failed_launches": 14, "pending_launches": 118, "consecutive_successful_landings": 73, "successful_landings": 451, "failed_landings": 26, "attempted_landings": 476, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "rocket": { "id": 8423, "configuration": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/161/?format=api", "name": "Falcon Heavy", "active": true, "reusable": true, "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://ll.thespacedevs.com/2.2.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": 504, "consecutive_successful_launches": 27, "successful_launches": 490, "failed_launches": 14, "pending_launches": 118, "consecutive_successful_landings": 73, "successful_landings": 451, "failed_landings": 26, "attempted_landings": 476, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "program": [], "variant": "Heavy", "alias": "", "min_stage": 3, "max_stage": 3, "length": 70.0, "diameter": 12.2, "maiden_flight": "2018-02-06", "launch_cost": "90000000", "launch_mass": 1400, "leo_capacity": 63800, "gto_capacity": 26700, "to_thrust": 22819, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-prod.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": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 11, "attempted_landings": 21, "successful_landings": 19, "failed_landings": 2, "consecutive_successful_landings": 13 }, "launcher_stage": [ { "id": 627, "type": "Core", "reused": null, "launcher_flight_number": null, "launcher": { "id": 117, "url": "https://ll.thespacedevs.com/2.2.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-prod.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://ll.thespacedevs.com/2.2.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-prod.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://ll.thespacedevs.com/2.2.0/launcher/117/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown FH", "status": "N/A", "image_url": "https://thespacedevs-prod.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, "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" }, "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": [ { "priority": 10, "source": "dragonfly.jhuapl.edu", "title": "Dragonfly", "description": "Explore and manipulate the Dragonfly rotorcraft lander on your computer screen or access an augmented reality version of the spacecraft on your cell phone.\n\nExplore and manipulate the Dragonfly rotorcraft lander on your computer screen or access an augmented reality version of the spacecraft on your...", "feature_image": null, "url": "https://dragonfly.jhuapl.edu/", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vid_urls": [] }, "pad": { "id": 87, "url": "https://ll.thespacedevs.com/2.2.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "description": "", "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://ll.thespacedevs.com/2.2.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "description": "The John F. Kennedy Space Center, located on Merritt Island, Florida, is one of NASA's ten field centers. Since 1968, KSC has been NASA's primary launch center of American spaceflight, research, and technology. Launch operations for the Apollo, Skylab and Space Shuttle programs were carried out from Kennedy Space Center Launch Complex 39 and managed by KSC. Located on the east coast of Florida, KSC is adjacent to Cape Canaveral Space Force Station (CCSFS).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 264, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 206, "orbital_launch_attempt_count": 205 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_li_image_20241020093505.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7239, "location_launch_attempt_count": 277, "pad_launch_attempt_count": 216, "agency_launch_attempt_count": 614, "orbital_launch_attempt_count_year": 3, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P187D", "mission_patches": [], "type": "detailed" }
