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/64a43bcc-f080-4121-91da-90731c46dc82/?format=api
{ "id": "64a43bcc-f080-4121-91da-90731c46dc82", "url": "https://ll.thespacedevs.com/2.2.0/launch/64a43bcc-f080-4121-91da-90731c46dc82/?format=api", "slug": "x-15-flight-150", "flightclub_url": null, "r_spacex_api_id": null, "name": "X-15 | Flight 150", "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-14T08:59:15Z", "updates": [], "net": "1965-09-28T18:08:00Z", "net_precision": null, "window_end": "1965-09-28T18:20:00Z", "window_start": "1965-09-28T18:08:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USAF", "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": "1947", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.af.mil", "wiki_url": "http://en.wikipedia.org/wiki/United_States_Air_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg" }, "rocket": { "id": 2987, "configuration": { "id": 209, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/209/?format=api", "name": "North American X-15", "active": false, "reusable": true, "description": "The North American X-15 was a hypersonic rocket-powered aircraft operated by the United States Air Force and the National Aeronautics and Space Administration as part of the X-plane series of experimental aircraft.", "family": "", "full_name": "North American X-15", "manufacturer": { "id": 999, "url": "https://ll.thespacedevs.com/2.2.0/agencies/999/?format=api", "name": "North American Aviation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.", "administrator": null, "founding_year": "1928", "launchers": "North American X-15", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/North_American_Aviation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png", "image_url": null, "nation_url": null }, "program": [ { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/program/20/?format=api", "name": "X-15", "description": "Experimental hypersonic rocket-powered aircraft.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_program_20210809102752.jpeg", "start_date": "1959-03-10T00:00:00Z", "end_date": "1968-12-12T00:00:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/North_American_X-15", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 15.47, "diameter": 6.61, "maiden_flight": "1959-06-08", "launch_cost": null, "launch_mass": 15195, "leo_capacity": null, "gto_capacity": null, "to_thrust": 286, "apogee": 108, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north_american__image_20210813101104.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/North_American_X-15", "total_launch_count": 13, "consecutive_successful_launches": 1, "successful_launches": 12, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 683, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/683/?format=api", "mission_end": "1965-09-28T18:20:00Z", "destination": "Suborbital", "launch_crew": [ { "id": 3542, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 695, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/695/?format=api", "name": "John B. McKay", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "PT12M", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1922-12-08", "date_of_death": "1975-04-27", "nationality": "American", "twitter": null, "instagram": null, "bio": "John Barron McKay was an American naval officer, World War II pilot, aeronautical engineer, test pilot, and astronaut. He flew the X-15 experimental spaceplane to over 50 miles in altitude on Flight 150.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john_b._mckay_image_20210801073638.jpg", "wiki": "https://en.wikipedia.org/wiki/John_B._McKay", "last_flight": "1965-09-28T18:08:00Z", "first_flight": "1965-09-28T18:08:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 3543, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 695, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/695/?format=api", "name": "John B. McKay", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "PT12M", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1922-12-08", "date_of_death": "1975-04-27", "nationality": "American", "twitter": null, "instagram": null, "bio": "John Barron McKay was an American naval officer, World War II pilot, aeronautical engineer, test pilot, and astronaut. He flew the X-15 experimental spaceplane to over 50 miles in altitude on Flight 150.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john_b._mckay_image_20210801073638.jpg", "wiki": "https://en.wikipedia.org/wiki/John_B._McKay", "last_flight": "1965-09-28T18:08:00Z", "first_flight": "1965-09-28T18:08:00Z" } } ], "spacecraft": { "id": 444, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/444/?format=api", "name": "X-15-3", "serial_number": "56-6672", "is_placeholder": false, "in_space": false, "time_in_space": "PT3H51M32S", "time_docked": "P0D", "flights_count": 11, "mission_ends_count": 11, "status": { "id": 3, "name": "Destroyed" }, "description": "Third X-15 experimental rocket plane. Destroyed during flight 191.", "spacecraft_config": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/13/?format=api", "name": "North American X-15", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png" }, "in_use": false, "capability": "Experimental aircraft used for Aircraft and Spacecraft design", "history": "The North American X-15 currently holds the record for the highest speed in a manned, powered aircraft.\r\n\r\nThe three variants of the X-15 flew nearly 200 times, with 13 of them going over 80km high.", "details": "The North American X-15 was a hypersonic rocket-powered aircraft operated by the United States Air Force and the National Aeronautics and Space Administration. The X-15 reached altitudes of over 80km and speeds of over 6000 km/h.\r\n\r\nThe X-15 had a wingspan of 6.8 meters, and length of 15.4", "maiden_flight": "1959-06-08", "height": 15.45, "diameter": 6.8, "human_rated": true, "crew_capacity": 1, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "~10 minute flights", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/North_American_X-15", "info_link": "https://airandspace.si.edu/collection-objects/north-american-x-15" } }, "landing": { "id": 1136, "attempt": true, "success": true, "description": "The X-15 aircraft successfully landed after this flight.", "downrange_distance": null, "location": { "id": 23, "name": "Edwards Air Force Base", "abbrev": "KEDW", "description": "Edwards Air Force Base in California.", "location": { "id": 162, "url": "https://ll.thespacedevs.com/2.2.0/location/162/?format=api", "name": "Edwards Air Force Base", "country_code": "USA", "description": "Edwards Air Force Base is a United States Air Force installation in California. Edwards is the home of the Air Force Test Center, Air Force Test Pilot School, and NASA's Armstrong Flight Research Center. It is the Air Force Materiel Command center for conducting and supporting research and development of flight, as well as testing and evaluating aerospace systems from concept to combat. It also hosts many test activities conducted by America's commercial aerospace industry.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_edwards_air_force_base_20230422085221.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 0, "total_landing_count": 0 }, "successful_landings": 66 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 1412, "name": "Flight 150", "description": "Flight 150 of the North American X-15 was a test flight conducted by NASA and the US Air Force in 1965. Piloted by John B. McKay it reached an altitude of 90.0 km.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 112, "url": "https://ll.thespacedevs.com/2.2.0/pad/112/?format=api", "agency_id": null, "name": "Edwards Air Force Base", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Edwards_Air_Force_Base", "map_url": "https://www.google.com/maps?q=34.905556,-117.883611", "latitude": "34.905556", "longitude": "-117.883611", "location": { "id": 144, "url": "https://ll.thespacedevs.com/2.2.0/location/144/?format=api", "name": "Air launch to Suborbital flight", "country_code": "???", "description": "", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_144_20200803142439.jpg", "timezone_name": "", "total_launch_count": 86, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_112_20200803143214.jpg", "total_launch_count": 13, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north_american__image_20210813101104.png", "infographic": null, "program": [ { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/program/20/?format=api", "name": "X-15", "description": "Experimental hypersonic rocket-powered aircraft.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_program_20210809102752.jpeg", "start_date": "1959-03-10T00:00:00Z", "end_date": "1968-12-12T00:00:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/North_American_X-15", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 14, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 283, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 52, "pad_turnaround": "P48DT22H44M", "mission_patches": [], "type": "detailed" }
