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/82995933-e6fd-4de8-8785-5d98c9feddbe/?format=api
{ "id": "82995933-e6fd-4de8-8785-5d98c9feddbe", "url": "https://ll.thespacedevs.com/2.2.0/launch/82995933-e6fd-4de8-8785-5d98c9feddbe/?format=api", "slug": "falcon-9-block-4-otv-5-x-37b", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon 9 Block 4 | OTV-5 (X-37B)", "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-06-14T09:46:09Z", "updates": [], "net": "2017-09-07T14:00:00Z", "net_precision": null, "window_end": "2017-09-07T18:55:00Z", "window_start": "2017-09-07T13:50:00Z", "probability": 50, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 494, "consecutive_successful_launches": 17, "successful_launches": 480, "failed_launches": 14, "pending_launches": 121, "consecutive_successful_landings": 63, "successful_landings": 441, "failed_landings": 26, "attempted_landings": 466, "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": 2027, "configuration": { "id": 145, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/145/?format=api", "name": "Falcon 9", "active": false, "reusable": true, "description": "The Full Thrust variants first stage includes all systems necessary for an operational re-use of stages while the second stage is operated as an expendable rocket stage.", "family": "Falcon", "full_name": "Falcon 9 Block 4", "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": 494, "consecutive_successful_launches": 17, "successful_launches": 480, "failed_launches": 14, "pending_launches": 121, "consecutive_successful_landings": 63, "successful_landings": 441, "failed_landings": 26, "attempted_landings": 466, "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": [ { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/program/11/?format=api", "name": "Commercial Resupply Services", "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "type": "Commercial" }, { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/commercial2520_program_20201129212219.png", "start_date": "2008-12-23T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "Block 4", "alias": "", "min_stage": 2, "max_stage": 2, "length": 71.0, "diameter": 3.65, "maiden_flight": "2015-12-22", "launch_cost": "50000000", "launch_mass": 546, "leo_capacity": 22800, "gto_capacity": 8305, "to_thrust": 6804, "apogee": 197, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon252092520block25204_image_20190222031140.jpeg", "info_url": "http://www.spacex.com/falcon9", "wiki_url": "https://en.wikipedia.org/wiki/Falcon_9_full_thrust", "total_launch_count": 12, "consecutive_successful_launches": 12, "successful_launches": 12, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 6, "successful_landings": 6, "failed_landings": 0, "consecutive_successful_landings": 6 }, "launcher_stage": [ { "id": 41, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 47, "url": "https://ll.thespacedevs.com/2.2.0/launcher/47/?format=api", "details": "Stage Expended", "flight_proven": true, "serial_number": "B1040", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/47_image_20190226083837.jpeg", "successful_landings": 1, "attempted_landings": 1, "flights": 2, "last_launch_date": "2018-06-04T04:45:00Z", "first_launch_date": "2017-09-07T14:00:00Z" }, "landing": { "id": 79, "attempt": true, "success": true, "description": "The first stage of the Falcon 9 rocket landed at LZ-1.", "downrange_distance": 14.9, "location": { "id": 4, "name": "Landing Zone 1", "abbrev": "LZ-1", "description": "LZ-1 Pad located at Cape Canaveral Space Force Station at the previous LC-13", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1015, "total_landing_count": 62 }, "successful_landings": 50 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": { "id": 792, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/792/?format=api", "mission_end": "2019-10-27T07:51:00Z", "destination": "Low Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 559, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/559/?format=api", "name": "X-37B 2", "serial_number": "2", "is_placeholder": false, "in_space": false, "time_in_space": "P2400DT10H50M", "time_docked": "P0D", "flights_count": 4, "mission_ends_count": 4, "status": { "id": 1, "name": "Active" }, "description": "Second X-37B. First flight on March 5, 2011.", "spacecraft_config": { "id": 30, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/30/?format=api", "name": "X-37B", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "BA", "description": "Boeing as a space agency has recently provided NASA with assistance on sending humans to the ISS from American with both their construction of the CST-100 Starliner crew capsule and their work on the SLS Avionics to return to the moon and beyond. Their ventures in GPS satellite systems and Tracking and Data Relay Satellites provide information about earth-orbiting craft to stations on the ground. They also enable research on the ISS and will be helping with the construction of the Lunar Gateway.", "administrator": "CEO: Kelly Ortberg", "founding_year": "1916", "launchers": "SLS", "spacecraft": "Starliner", "parent": null, "image_url": null, "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing_logo_20201128183345.png" }, "in_use": true, "capability": "It is boosted into space by a launch vehicle, then re-enters Earth's atmosphere and lands as a spaceplane. The X-37 is operated by the United States Space Force for orbital spaceflight missions intended to demonstrate reusable space technologies.", "history": "In 1999, NASA selected Boeing Integrated Defense Systems to design and develop an orbital vehicle, built by the California branch of Boeing's Phantom Works. Over a four-year period, a total of US$192 million was spent on the project, with NASA contributing US$109 million, the U.S. Air Force US$16 million, and Boeing US$67 million. In late 2002, a new US$301 million contract was awarded to Boeing as part of NASA's Space Launch Initiative framework.\r\n\r\nThe X-37 was transferred from NASA to the Defense Advanced Research Projects Agency (DARPA) on 13 September 2004. Thereafter, the program became a classified project. DARPA promoted the X-37 as part of the independent space policy that the United States Department of Defense has pursued since the 1986 Challenger disaster.", "details": "The Boeing X-37, also known as the Orbital Test Vehicle (OTV), is a reusable robotic spacecraft. It is boosted into space by a launch vehicle, then re-enters Earth's atmosphere and lands as a spaceplane. The X-37 is operated by the United States Space Force for orbital spaceflight missions intended to demonstrate reusable space technologies. It is a 120-percent-scaled derivative of the earlier Boeing X-40. The X-37 began as a NASA project in 1999, before being transferred to the United States Department of Defense in 2004. Until 2019, the program was managed by Air Force Space Command.", "maiden_flight": "2010-04-22", "height": 8.92, "diameter": 4.55, "human_rated": false, "crew_capacity": null, "payload_capacity": 227, "payload_return_capacity": null, "flight_life": "Multiple years in orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-37b_image_20221113134355.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Boeing_X-37", "info_link": "https://www.boeing.com/space/x37b/index.page" } }, "landing": { "id": 1150, "attempt": true, "success": true, "description": "The X-37B spaceplane successfully landed after this flight.", "downrange_distance": null, "location": { "id": 24, "name": "Shuttle Landing Facility", "abbrev": "KTTS", "description": "Airport used for Space Shuttle landings, part of the Kennedy Space Center.", "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": 261, "total_landing_count": 0 }, "successful_landings": 81 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 439, "name": "OTV-5 (X-37B)", "description": "It is the fifth flight of the X-37B program. United States Air Force Orbital Test Vehicle, built by Boeing, is an unmanned 5000 kg, 8.8 m-long reusable mini-spaceplane capable of autonomous re-entry and landing.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "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": 261, "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": 203, "orbital_launch_attempt_count": 202 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Orbital Test Vehicle 5 (OTV-5) Mission", "description": "SpaceX’s Falcon 9 rocket will launch the U.S. Air Force’s X-37B Orbital Test Vehicle (OTV) on its fifth mission. SpaceX is targeting launch of OTV-5 from Lau...", "feature_image": "https://i.ytimg.com/vi/9M6Zvi-fFv4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=9M6Zvi-fFv4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon252092520block25204_image_20190222031140.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5671, "location_launch_attempt_count": 163, "pad_launch_attempt_count": 106, "agency_launch_attempt_count": 47, "orbital_launch_attempt_count_year": 56, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 10, "agency_launch_attempt_count_year": 13, "pad_turnaround": "P23DT21H28M23S", "mission_patches": [ { "id": 531, "name": "OTV-5 (X-37B) Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/otv-525202528_mission_patch_20211031044141.png", "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } } ], "type": "detailed" }
