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/24756fd7-8ee6-431d-99f7-622d2b5683ce/?format=api
{ "id": "24756fd7-8ee6-431d-99f7-622d2b5683ce", "url": "https://ll.thespacedevs.com/2.2.0/launch/24756fd7-8ee6-431d-99f7-622d2b5683ce/?format=api", "slug": "saturn-v-apollo-6", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn V | Apollo 6", "status": { "id": 7, "name": "Launch was a Partial Failure", "abbrev": "Partial Failure", "description": "Either the launch vehicle reached orbit but did not deliver its payload in the targeted orbit, or an exceptional event made it impossible to consider the mission a success." }, "last_updated": "2023-06-14T04:15:48Z", "updates": [], "net": "1968-04-04T12:00:01Z", "net_precision": null, "window_end": "1968-04-04T12:00:01Z", "window_start": "1968-04-04T12:00:01Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 214, "configuration": { "id": 93, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/93/?format=api", "name": "Saturn V", "active": false, "reusable": false, "description": "The Saturn V was a human-rated expendable rocket used by NASA between 1967 and 1973. Most notably, the Saturn V took the Apollo program to the Moon. It still remains the world's tallest, heaviest, and most powerful rocket ever brought to operational status and is the only launch vehicle to take humans beyond LEO.", "family": "Saturn", "full_name": "Saturn V", "manufacturer": { "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", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "program": [ { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/program/4/?format=api", "name": "Apollo", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/apollo_program_20200820200202.png", "start_date": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "V", "alias": "", "min_stage": 3, "max_stage": 3, "length": 110.6, "diameter": 10.1, "maiden_flight": "1967-11-09", "launch_cost": null, "launch_mass": 2970, "leo_capacity": 140000, "gto_capacity": null, "to_thrust": 35100, "apogee": null, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/saturn2520v_image_20190222030036.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Saturn_V", "total_launch_count": 13, "consecutive_successful_launches": 11, "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": 24, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/24/?format=api", "mission_end": "1968-04-04T21:57:00Z", "destination": "Highly Elliptical Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/24/?format=api", "name": "Apollo CSM-020", "serial_number": "CSM-020", "is_placeholder": false, "in_space": false, "time_in_space": "PT9H56M59S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "CSM-020 was an Apollo Command & Service Module used in the Apollo 6 mission.", "spacecraft_config": { "id": 10, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/10/?format=api", "name": "Apollo Command/Service Module", "type": { "id": 2, "name": "Capsule" }, "agency": { "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": "", "parent": "Boeing", "image_url": null, "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png" }, "in_use": false, "capability": "Cargo and Human Transportation to Lunar Orbit", "history": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972.", "details": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972. The CSM functioned as a mother ship which carried a crew of three astronauts and the second Apollo spacecraft, the Lunar Module, to lunar orbit, and brought the astronauts back to Earth. It consisted of two parts: the conical Command Module, a cabin that housed the crew and carried equipment needed for atmospheric reentry and splashdown; and the cylindrical Service Module which provided propulsion, electrical power and storage for various consumables required during a mission. An umbilical connection transferred power and consumables between the two modules. Just before reentry of the Command Module on the return home, the umbilical connection was severed and the Service Module was cast off and allowed to burn up in the atmosphere.", "maiden_flight": "1966-02-26", "height": 11.0, "diameter": 3.9, "human_rated": true, "crew_capacity": 3, "payload_capacity": 1050, "payload_return_capacity": null, "flight_life": "14 days", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/apollo2520command2fservice2520module_image_20190207032507.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Apollo_Command/Service_Module", "info_link": "" } }, "landing": { "id": 375, "attempt": true, "success": true, "description": "The Apollo spacecraft successfully splashed down in the Pacific Ocean.", "downrange_distance": null, "location": { "id": 18, "name": "Pacific Ocean", "abbrev": "PAC", "description": "Pacific Ocean", "location": null, "successful_landings": 3 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 916, "name": "Apollo 6", "description": "Apollo 6 was intended to send a Command and Service Module (CSM) plus a Lunar Module Test Article (LTA), a simulated Lunar Module (LM) with mounted structural vibration sensors, into a translunar trajectory. However, the Moon would not be in position for a translunar flight, and the Service Module engine would be fired about five minutes later to slow the craft, dropping its apogee to 11,989 nautical miles (22,204 km) and causing the CSM to return to Earth, simulating a \"direct-return\" abort. On the return leg, the engine would fire once more to accelerate the craft to simulate the nominal lunar return trajectory with a re-entry angle of -6.5 degrees and velocity of 36,500 feet per second (11,100 m/s). The entire mission would last about 10 hours.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical" }, "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": null, "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": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 237, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_87_20200803143537.jpg", "total_launch_count": 179, "orbital_launch_attempt_count": 178 }, "infoURLs": [ { "priority": 0, "source": null, "title": "Apollo 6 - Wikipedia", "description": "Second test flight of the Apollo Saturn V rocket\n\nApollo 6 (April 4, 1968), also known as AS-502, was the third and final uncrewed flight in the United States' Apollo Program, and the second test of the Saturn V launch vehicle. It qualified the Saturn V to be used on crewed missions, as happened for...", "feature_image": null, "url": "https://en.wikipedia.org/wiki/Apollo_6", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Apollo 6: The second saturn 5 rocket launch, April 4, 1968", "description": "VIA AP from NASA documentary movie. Apollo 6 Wikipedia: https://en.wikipedia.org/wiki/Apollo_6 NASA INFO: http://nssdc.gsfc.nasa.gov/nmc/spacecraftDisplay.do...", "feature_image": "https://i.ytimg.com/vi/sHNEpsjtQZw/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=sHNEpsjtQZw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Apollo 6 launch TV footage", "description": "Low quality TV footage of the troubled, second Saturn V test flight. Two segments shown: 1) Liftoff through interstage separation 2) From T+7:35 when the los...", "feature_image": "https://i.ytimg.com/vi/1Tv9HiuWc5A/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=1Tv9HiuWc5A", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/saturn2520v_image_20190222030036.jpeg", "infographic": null, "program": [ { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/program/4/?format=api", "name": "Apollo", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/apollo_program_20200820200202.png", "start_date": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 814, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 93, "orbital_launch_attempt_count_year": 27, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P147D", "mission_patches": [], "type": "detailed" }
