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/cdeb321f-0860-4064-ba76-4ad0f9022103/?format=api
{ "id": "cdeb321f-0860-4064-ba76-4ad0f9022103", "url": "https://ll.thespacedevs.com/2.2.0/launch/cdeb321f-0860-4064-ba76-4ad0f9022103/?format=api", "slug": "falcon-1-flight-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon 1 | Flight 3", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-07-08T08:49:29Z", "updates": [], "net": "2008-08-03T03:34:00Z", "net_precision": null, "window_end": "2008-08-03T03:34:00Z", "window_start": "2008-08-03T03:34:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Residual stage 1 thrust led to collision between stage 1 and stage 2 during separation.", "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": 723, "consecutive_successful_launches": 208, "successful_launches": 708, "failed_launches": 15, "pending_launches": 127, "consecutive_successful_landings": 15, "successful_landings": 666, "failed_landings": 29, "attempted_landings": 694, "info_url": "https://www.spacex.com/", "wiki_url": "https://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/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg" }, "rocket": { "id": 1398, "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": 723, "consecutive_successful_launches": 208, "successful_launches": 708, "failed_launches": 15, "pending_launches": 127, "consecutive_successful_landings": 15, "successful_landings": 666, "failed_landings": 29, "attempted_landings": 694, "info_url": "https://www.spacex.com/", "wiki_url": "https://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/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.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": 365, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/launcher/5/?format=api", "details": "Residual stage-1 thrust led to collision between stage 1 and stage 2.", "flight_proven": true, "serial_number": "F1 B0003", "status": "lost", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/5_image_20230707190424.jpg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2008-08-03T03:34:00Z", "first_launch_date": "2008-08-03T03:34:00Z" }, "landing": { "id": 1190, "attempt": false, "success": null, "description": "Booster destroyed during recontact with second stage.", "downrange_distance": null, "location": { "id": 15, "name": "South Pacific", "abbrev": "PAC", "description": "Pacific Ocean off the coast of Mahia Peninsula, New Zealand.", "location": { "id": 10, "url": "https://ll.thespacedevs.com/2.2.0/location/10/?format=api", "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand", "country_code": "NZL", "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg", "timezone_name": "Pacific/Auckland", "total_launch_count": 80, "total_landing_count": 17 }, "successful_landings": 4 }, "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": 6460, "name": "Flight 3", "description": "Trailblazer, PRESat, NanoSail-D and a Celestis payload were part of the rideshare on the 3rd Falcon 1 launch.", "launch_designator": null, "type": "Dedicated Rideshare", "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#Third_flight", "type": null, "language": null }, { "priority": 0, "source": null, "title": "FALCON 1, FLIGHT 3 MISSION SUMMARY", "description": "Timing is Everything", "feature_image": null, "url": "http://www.spacex.com/news/2013/02/11/falcon-1-flight-3-mission-summary", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": "youtube.com", "publisher": "Spacevidcast (now TMRO -- see new channel)", "title": "Launch Failure of SpaceX Falcon 1 - Flight 3", "description": "SpaceX had a rough day. After an initial abort on the launch-pad at T-0 seconds they were finally able to get the Falcon 1 rocket in the air only to have the first stage not properly jettison, which ...", "feature_image": "https://i.ytimg.com/vi/2eGiqqoYP5E/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=2eGiqqoYP5E", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2008-08-03T06:57:25Z", "end_time": "2008-08-03T07:04:35Z" }, { "priority": 0, "source": "youtube.com", "publisher": "TheSystemsAlliance", "title": "Falcon 1 Flight 3", "description": "3rd launch of Falcon 1 (Failed) from Kwajalein Atoll \n3 August 2008, 03:34 GMT\nPayload: Trailblazer (ORS), PRESat (NASA), NanoSail-D (NASA), Explorers (Celestis)\nResidual stage 1 thrust led to collisi...", "feature_image": "https://i.ytimg.com/vi/Qz0yJ8N3cA0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Qz0yJ8N3cA0", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2012-02-17T13:02:22Z", "end_time": "2012-02-17T13:05:21Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_image_20190222030438.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4923, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 38, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P501DT2H24M", "mission_patches": [ { "id": 573, "name": "Falcon 1 | Flight 3 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/falcon2520125_mission_patch_20211031044208.png", "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } } ], "type": "detailed" }