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/0560cfb0-ed19-4e8b-9fe9-728feb0f817c/?format=api
{ "id": "0560cfb0-ed19-4e8b-9fe9-728feb0f817c", "url": "https://ll.thespacedevs.com/2.2.0/launch/0560cfb0-ed19-4e8b-9fe9-728feb0f817c/?format=api", "slug": "falcon-1-ratsat", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon 1 | RatSat", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-07-08T08:51:15Z", "updates": [], "net": "2008-09-28T23:15:00Z", "net_precision": null, "window_end": "2008-09-28T23:15:00Z", "window_start": "2008-09-28T23:15:00Z", "probability": -1, "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": 506, "consecutive_successful_launches": 29, "successful_launches": 492, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 75, "successful_landings": 453, "failed_landings": 26, "attempted_landings": 478, "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": 1400, "configuration": { "id": 133, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/133/?format=api", "name": "Falcon 1", "active": false, "reusable": false, "description": "The Falcon 1 was the first launch vehicle developed and manufactured by SpaceX in 2006. It is an expendable, two stage rocket where each stage is powered by a single LOX/RP1 engine.", "family": "Falcon", "full_name": "Falcon 1", "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": 506, "consecutive_successful_launches": 29, "successful_launches": 492, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 75, "successful_landings": 453, "failed_landings": 26, "attempted_landings": 478, "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": "1", "alias": "", "min_stage": 2, "max_stage": 2, "length": 22.25, "diameter": 1.7, "maiden_flight": "2006-03-24", "launch_cost": "7000000", "launch_mass": 33, "leo_capacity": 470, "gto_capacity": null, "to_thrust": 454, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_image_20190222030438.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Falcon_1", "total_launch_count": 5, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 2, "successful_landings": 0, "failed_landings": 2, "consecutive_successful_landings": 0 }, "launcher_stage": [ { "id": 366, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/launcher/6/?format=api", "details": "Initially scheduled for 23–25 Sep, carried dummy payload – mass simulator, 165 kg (originally intended to be RazakSAT.", "flight_proven": true, "serial_number": "F1 B0004", "status": "lost", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/6_image_20230707190325.jpg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2008-09-28T23:15:00Z", "first_launch_date": "2008-09-28T23:15:00Z" }, "landing": { "id": 1189, "attempt": false, "success": null, "description": "Booster was expended during its first flight.", "downrange_distance": null, "location": { "id": 18, "name": "Pacific Ocean", "abbrev": "PAC", "description": "Pacific Ocean", "location": null, "successful_landings": 46 }, "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": 6461, "name": "RatSat", "description": "RatSat was an aluminum mass simulator on the fourth flight of the Falcon 1 rocket.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 107, "url": "https://ll.thespacedevs.com/2.2.0/pad/107/?format=api", "agency_id": null, "name": "Omelek Island", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Omelek_Island", "map_url": "https://www.google.com/maps?q=9.047861,167.743", "latitude": "9.047861", "longitude": "167.743", "location": { "id": 142, "url": "https://ll.thespacedevs.com/2.2.0/location/142/?format=api", "name": "Ronald Reagan Ballistic Missile Defense Test Site, Kwajalein Atoll, Marshall Islands", "country_code": "MHL", "description": "The Ronald Reagan Ballistic Missile Defense Test Site is a missile test range in Marshall Islands. It covers about 750,000 square miles (1,900,000 km2) and includes rocket launch sites at the Kwajalein Atoll (on multiple islands), Wake Island, and Aur Atoll. It primarily functions as a test facility for U.S. missile defense and space research programs.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_142_20200803142511.jpg", "timezone_name": "Pacific/Tarawa", "total_launch_count": 5, "total_landing_count": 0 }, "country_code": "MHL", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_107_20200803143450.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5 }, "infoURLs": [ { "priority": 0, "source": null, "title": "Falcon 1 - Wikipedia", "description": "Falcon 1 was a small-lift launch vehicle that was operated from 2006 to 2009[5] by SpaceX, an American aerospace manufacturer. On 28 September 2008, Falcon 1 became the first privately-developed fully liquid-fueled launch vehicle to go into orbit around the Earth.[6][7]: 203\n\nThe two-stage-to-orbit ...", "feature_image": null, "url": "https://en.wikipedia.org/wiki/Falcon_1#Fourth_flight", "type": null, "language": null }, { "priority": 0, "source": null, "title": "FLIGHT 4 LAUNCH UPDATE", "description": "A week spent reviewing data has confirmed that the flight went really well, including the coast and restart. The mood here at SpaceX is just ecstatic! This is the culmination of six years of hard work by a very talented team. It is also a great relief for me, who led the overall design of the rocket...", "feature_image": null, "url": "http://www.spacex.com/news/2013/02/11/flight-4-launch-update", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "SpaceX Falcon 1 (Flight 4 - High Roller) High Quality", "description": "Falcon 1 Flight 4 music video set to Crystal Method's \"High Roller\". Video created by SpaceX.", "feature_image": "https://i.ytimg.com/vi/eWtfE1GHNjg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=eWtfE1GHNjg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "SpaceX reaches orbit with Falcon 1 - Flight 4 (full video including Elon Musk statement)", "description": "SpaceX is the only private company to ever reach earth orbit with their Falcon 1 rocket. This is the FULL 40 minute webcast from about T-10 minutes until wel...", "feature_image": "https://i.ytimg.com/vi/8FQhtMrUQlE/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=8FQhtMrUQlE", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "SpaceX - Falcon 1, Flight 4", "description": "A short compilation of highlights from flight 4. More information on SpaceX: http://www.spacex.com/ http://twitter.com/spacex http://www.facebook.com/SpaceX", "feature_image": "https://i.ytimg.com/vi/dLQ2tZEH6G0/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=dLQ2tZEH6G0", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_image_20190222030438.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4935, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 50, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P56DT19H41M", "mission_patches": [ { "id": 572, "name": "Falcon 1 | RatSat Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/falcon2520125_mission_patch_20211031044202.png", "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } } ], "type": "detailed" }
