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/28d44a8a-0574-4d2b-85be-8a45a560b70f/?format=api
{ "id": "28d44a8a-0574-4d2b-85be-8a45a560b70f", "url": "https://ll.thespacedevs.com/2.2.0/launch/28d44a8a-0574-4d2b-85be-8a45a560b70f/?format=api", "slug": "atlas-v-501-otv-2-x-37b-usa-226", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 501 | OTV-2 (X-37B) (USA-226)", "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-14T17:42:18Z", "updates": [], "net": "2011-03-05T22:46:00Z", "net_precision": null, "window_end": "2011-03-05T22:46:00Z", "window_start": "2011-03-05T22:46:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 45, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 1515, "configuration": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/4/?format=api", "name": "Atlas V 501", "active": true, "reusable": false, "description": "Atlas V with 5m Fairing, 0 SRB, 1 Centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 501", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 45, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "501", "alias": "", "min_stage": 1, "max_stage": 2, "length": 58.3, "diameter": 3.8, "maiden_flight": "2010-04-22", "launch_cost": "120000000", "launch_mass": 334, "leo_capacity": 8210, "gto_capacity": 3780, "to_thrust": 3827, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520501_image_20190222030851.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": null, "total_launch_count": 8, "consecutive_successful_launches": 8, "successful_launches": 8, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 789, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/789/?format=api", "mission_end": "2012-06-16T12:48: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": 1148, "attempt": true, "success": true, "description": "The X-37B spaceplane successfully landed after this flight.", "downrange_distance": null, "location": { "id": 27, "name": "Vandenberg Space Force Base", "abbrev": "KVBG", "description": "Vandenberg Space Force Base, CA, USA", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 801, "total_landing_count": 26 }, "successful_landings": 4 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 450, "name": "OTV-2 (X-37B) (USA-226)", "description": "It is the first flight of the second Boeing X-37B, a United States Air Force Orbital Test Vehicle 2, which is an unmanned 5000 kg, 8.8 m-long reusable mini-spaceplane capable of autonomous re-entry and landing. The OTV-2 mission was designed to test new technologies, however the specific identity of the spaceship's payload was not revealed. The mission concluded after 468 days in orbit.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "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 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 114, "orbital_launch_attempt_count": 114 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Atlas V OTV-2 Launch Highlights", "description": "An Atlas V launched the second Orbital Test Vehicle mission for the United States Air force from Space Launch Complex-41 at Cape Canaveral Air Force Station ...", "feature_image": "https://i.ytimg.com/vi/OtBPliJfVTk/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=OtBPliJfVTk", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520501_image_20190222030851.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5117, "location_launch_attempt_count": 677, "pad_launch_attempt_count": 48, "agency_launch_attempt_count": 48, "orbital_launch_attempt_count_year": 11, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P203DT11H39M", "mission_patches": [], "type": "detailed" }
