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/366725ae-a846-4cb2-bdae-58ee8b1715ab/?format=api
{ "id": "366725ae-a846-4cb2-bdae-58ee8b1715ab", "url": "https://ll.thespacedevs.com/2.2.0/launch/366725ae-a846-4cb2-bdae-58ee8b1715ab/?format=api", "slug": "little-joe-ii-a-004", "flightclub_url": null, "r_spacex_api_id": null, "name": "Little Joe II | A-004", "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-14T04:30:58Z", "updates": [], "net": "1966-01-20T15:17:01Z", "net_precision": null, "window_end": "1966-01-20T15:17:01Z", "window_start": "1966-01-20T15:17:01Z", "probability": null, "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": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "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://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 7427, "configuration": { "id": 470, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/470/?format=api", "name": "Little Joe II", "active": false, "reusable": false, "description": "American rocket used from 1963 to 1966 for five uncrewed suborbital tests of the Apollo spacecraft launch escape system and of the command module parachute recovery system in abort mode.", "family": "Little Joe", "full_name": "Little Joe II", "manufacturer": { "id": 1004, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1004/?format=api", "name": "Convair", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": "1943", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "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/Convair", "logo_url": null, "image_url": null, "nation_url": 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://thespacedevs-prod.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": "II", "alias": "", "min_stage": 1, "max_stage": 1, "length": 26.2, "diameter": 3.9, "maiden_flight": "1963-08-28", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_ii_image_20210901072351.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Little_Joe_II", "total_launch_count": 5, "consecutive_successful_launches": 1, "successful_launches": 4, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 692, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/692/?format=api", "mission_end": "1966-01-20T15:23:51Z", "destination": "Suborbital", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 481, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/481/?format=api", "name": "Apollo CSM-002", "serial_number": "CSM-002", "is_placeholder": false, "in_space": false, "time_in_space": "PT6M50S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Apollo CSM used for the A-004 suborbital test flight.", "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://thespacedevs-prod.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://thespacedevs-prod.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": 370, "attempt": true, "success": true, "description": "The Apollo boilerplate spacecraft successfully landed after this test flight of the launch escape vehicle.", "downrange_distance": null, "location": { "id": 20, "name": "White Sands Missile Range", "abbrev": "WSMR", "description": "US Army testing area and firing range located in the US state of New Mexico.", "location": { "id": 155, "url": "https://ll.thespacedevs.com/2.2.0/location/155/?format=api", "name": "White Sands Missile Range", "country_code": "USA", "description": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg", "timezone_name": "America/Denver", "total_launch_count": 5, "total_landing_count": 0 }, "successful_landings": 5 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 5816, "name": "A-004", "description": "A-004 was the sixth and final test of the Apollo launch escape vehicle and the first flight of a Block I production-type Apollo Command/Service Module.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 194, "url": "https://ll.thespacedevs.com/2.2.0/pad/194/?format=api", "agency_id": 165, "name": "Launch Complex 36", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/White_Sands_Launch_Complex_36", "map_url": "https://www.google.com/maps?q=32.416944,-106.321944", "latitude": "32.416944", "longitude": "-106.321944", "location": { "id": 155, "url": "https://ll.thespacedevs.com/2.2.0/location/155/?format=api", "name": "White Sands Missile Range", "country_code": "USA", "description": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg", "timezone_name": "America/Denver", "total_launch_count": 5, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_complex_36_20210901072730.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_ii_image_20210901072351.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://thespacedevs-prod.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": null, "location_launch_attempt_count": 5, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 75, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P246DT2H15M57S", "mission_patches": [], "type": "detailed" }
