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/0098c032-73de-4c6f-8d73-5d68b9a12fdf/?format=api
{ "id": "0098c032-73de-4c6f-8d73-5d68b9a12fdf", "url": "https://ll.thespacedevs.com/2.0.0/launch/0098c032-73de-4c6f-8d73-5d68b9a12fdf/?format=api", "launch_library_id": 1585, "slug": "falcon-heavy-otv-7-x-37b-ussf-52", "name": "Falcon Heavy | OTV-7 (X-37B) (USSF-52)", "status": { "id": 3, "name": "Success" }, "net": "2023-12-29T01:07:00Z", "window_end": "2023-12-29T01:17:00Z", "window_start": "2023-12-29T01:07:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": 90, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://ll.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": 503, "consecutive_successful_launches": 26, "successful_launches": 489, "failed_launches": 14, "pending_launches": 119, "consecutive_successful_landings": 72, "successful_landings": 450, "failed_landings": 26, "attempted_landings": 475, "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": 162, "configuration": { "id": 161, "launch_library_id": 58, "url": "https://ll.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://ll.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": 503, "consecutive_successful_launches": 26, "successful_launches": 489, "failed_launches": 14, "pending_launches": 119, "consecutive_successful_landings": 72, "successful_landings": 450, "failed_landings": 26, "attempted_landings": 475, "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_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 }, "launcher_stage": [ { "id": 235, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 127, "url": "https://ll.thespacedevs.com/2.0.0/launcher/127/?format=api", "details": "Falcon Heavy core booster expended during the USSF-52 mission.", "flight_proven": false, "serial_number": "B1084", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/127_image_20231229222119.jpeg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2023-12-29T01:07:00Z", "first_launch_date": "2023-12-29T01:07:00Z" }, "landing": { "id": 263, "attempt": false, "success": null, "description": "B1084 was expended after its first flight.", "location": { "id": 6, "name": "Atlantic Ocean", "abbrev": "ATL", "description": "Atlantic Ocean", "location": null, "successful_landings": 37 }, "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 }, { "id": 237, "type": "Strap-On Booster", "reused": true, "launcher_flight_number": 5, "launcher": { "id": 86, "url": "https://ll.thespacedevs.com/2.0.0/launcher/86/?format=api", "details": "Side booster paired with B1064, launched 3 USSF missions, EchoStar 24 and the Psyche mission before expended during launch of Europa Clipper.", "flight_proven": true, "serial_number": "B1065", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/85_image_20221102112709.jpeg", "successful_landings": 5, "attempted_landings": 5, "flights": 6, "last_launch_date": "2024-10-14T16:06:00Z", "first_launch_date": "2022-11-01T13:41:00Z" }, "landing": { "id": 265, "attempt": true, "success": true, "description": "B1065 has landed back at the launch site after its fifth flight.", "location": { "id": 5, "name": "Landing Zone 2", "abbrev": "LZ-2", "description": "LZ-2 Pad located at Cape Canaveral Space Force Station at the previous LC-13. Directly next to LZ-1", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1020, "total_landing_count": 64 }, "successful_landings": 12 }, "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": "2023-10-13T14:19:43Z", "turn_around_time_days": 76, "previous_flight": { "id": "66133437-db31-4098-8e3e-cf34c8125f9b", "name": "Falcon Heavy | Psyche" } }, { "id": 236, "type": "Strap-On Booster", "reused": true, "launcher_flight_number": 5, "launcher": { "id": 85, "url": "https://ll.thespacedevs.com/2.0.0/launcher/85/?format=api", "details": "Side booster paired with B1065, launched 3 USSF missions, EchoStar 24 and the Psyche mission before expended during launch of Europa Clipper.", "flight_proven": true, "serial_number": "B1064", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/85_image_20221102112709.jpeg", "successful_landings": 5, "attempted_landings": 5, "flights": 6, "last_launch_date": "2024-10-14T16:06:00Z", "first_launch_date": "2022-11-01T13:41:00Z" }, "landing": { "id": 264, "attempt": true, "success": true, "description": "B1064 has landed back at the launch site after its fifth flight.", "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.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1020, "total_landing_count": 64 }, "successful_landings": 51 }, "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": "2023-10-13T14:19:43Z", "turn_around_time_days": 76, "previous_flight": { "id": "66133437-db31-4098-8e3e-cf34c8125f9b", "name": "Falcon Heavy | Psyche" } } ], "spacecraft_stage": { "id": 822, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/822/?format=api", "mission_end": "2025-03-07T07:22:00Z", "destination": "Elliptical Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 559, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/559/?format=api", "name": "X-37B 2", "serial_number": "2", "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.0.0/config/spacecraft/30/?format=api", "name": "X-37B", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 80, "url": "https://ll.thespacedevs.com/2.0.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 }, "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, "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" } }, "docking_events": [] } }, "mission": { "id": 6447, "launch_library_id": null, "name": "OTV-7 (X-37B) (USSF-52)", "description": "It is the seventh flight of the X-37B program. United States Air Force Orbital Test Vehicle is built by Boeing. It's an uncrewed 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": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical" } }, "pad": { "id": 87, "url": "https://ll.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://ll.thespacedevs.com/2.0.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "total_launch_count": 264, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 206 }, "infoURLs": [ { "priority": 10, "title": "SpaceX", "description": "SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.", "feature_image": null, "url": "https://www.spacex.com/launches/mission/?missionId=ussf-52" } ], "vidURLs": [ { "priority": 7, "title": "SpaceX OTV-7 (X-37B) (USSF-52)", "description": "On Friday December 29, 2023, SpaceX launched the OTV-7 (X-37B) (USSF-52) mission with a Falcon Heavy from Launch Complex 39A at Kennedy Space Center, FL, USA...", "feature_image": "https://i.ytimg.com/vi/3iZrzJhUvRU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=3iZrzJhUvRU" }, { "priority": 8, "title": "Watch live: SpaceX Falcon Heavy launches secretive X-37B military spaceplane", "description": "Watch live coverage as SpaceX launches a Falcon Heavy rocket carrying the U.S. military's secretive X-37B spaceplane. Liftoff from historic launch pad 39A at...", "feature_image": "https://i.ytimg.com/vi/wnfddhDuWDE/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=wnfddhDuWDE" }, { "priority": 9, "title": "SpaceX Launches Falcon Heavy for the USSF-52 / X-37B Spaceplane", "description": "SpaceX's fifth Falcon Heavy of the year is set to liftoff from Launch Complex 39A at NASA's Kennedy Space Center carrying the US Space Force X-37B spaceplane...", "feature_image": "https://i.ytimg.com/vi/jqeM-CWz2Eo/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=jqeM-CWz2Eo" }, { "priority": 10, "title": "Livestream on X", "description": "This browser is no longer supported.\n\nPlease switch to a supported browser to continue using twitter.com. You can see a list of supported browsers in our Help Center.", "feature_image": null, "url": "https://twitter.com/i/broadcasts/1ynKOyeDmrwJR" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520heav_image_20231229055756.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6587, "location_launch_attempt_count": 226, "pad_launch_attempt_count": 168, "agency_launch_attempt_count": 310, "orbital_launch_attempt_count_year": 219, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 13, "agency_launch_attempt_count_year": 97 }
