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/646b10d8-b33b-4241-8982-3ea60a4fd3a8/?format=api
{ "id": "646b10d8-b33b-4241-8982-3ea60a4fd3a8", "url": "https://ll.thespacedevs.com/2.2.0/launch/646b10d8-b33b-4241-8982-3ea60a4fd3a8/?format=api", "slug": "little-joe-lj-5b", "flightclub_url": null, "r_spacex_api_id": null, "name": "Little Joe | LJ-5B", "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:31:01Z", "updates": [], "net": "1961-04-28T14:03:00Z", "net_precision": null, "window_end": "1961-04-28T14:03:00Z", "window_start": "1961-04-28T14:03:00Z", "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": 7442, "configuration": { "id": 473, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/473/?format=api", "name": "Little Joe", "active": false, "reusable": false, "description": "Little Joe was a solid-fueled booster rocket used by NASA for eight launches from 1959-1960 from Wallops Island, Virginia to test the launch escape system and heat shield for Project Mercury capsules.", "family": "Little Joe", "full_name": "Little Joe", "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": 2, "url": "https://ll.thespacedevs.com/2.2.0/program/2/?format=api", "name": "Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "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/project2520mer_program_20200820194755.png", "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 17.0, "diameter": null, "maiden_flight": "1959-08-21", "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_image_20210901081353.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Little_Joe_(rocket)", "total_launch_count": 8, "consecutive_successful_launches": 1, "successful_launches": 3, "failed_launches": 5, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 701, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/701/?format=api", "mission_end": "1961-04-28T14:08:00Z", "destination": "Suborbital", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 485, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/485/?format=api", "name": "Mercury No.14", "serial_number": "14", "is_placeholder": false, "in_space": false, "time_in_space": "PT10M", "time_docked": "P0D", "flights_count": 2, "mission_ends_count": 2, "status": { "id": 4, "name": "Single Use" }, "description": "Mercury No.14 is the Mercury capsule used for the Little Joe 5A mission.", "spacecraft_config": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/11/?format=api", "name": "Mercury", "type": { "id": 2, "name": "Capsule" }, "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": "Acting Administrator: James Free", "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": "Human transportation to upper Earth atmosphere and low Earth orbit.", "history": "The Mercury spacecraft was the manned capsule used for suborbital and orbital launches during the Project Mercury, the first human spaceflight program of the United States, from 1958 through 1963.", "details": "The Mercury spacecraft's principal designer was Maxime Faget, who started research for manned spaceflight during the time of the NACA. With 100 cubic feet (2.8 m3) of habitable volume, the capsule was just large enough for a single crew member. Inside were 120 controls: 55 electrical switches, 30 fuses and 35 mechanical levers. The heaviest spacecraft, Mercury-Atlas 9, weighed 3,000 pounds (1,400 kg) fully loaded. Its outer skin was made of René 41, a nickel alloy able to withstand high temperatures.", "maiden_flight": "1961-05-05", "height": 3.3, "diameter": 1.8, "human_rated": true, "crew_capacity": 1, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Between 15 minutes and 3 days.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Project_Mercury#Spacecraft", "info_link": "" } }, "landing": { "id": 483, "attempt": true, "success": true, "description": "The Mercury spacecraft safely splashed down in the Atlantic Ocean.", "downrange_distance": null, "location": { "id": 6, "name": "Atlantic Ocean", "abbrev": "ATL", "description": "Atlantic Ocean", "location": null, "successful_landings": 37 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 5832, "name": "LJ-5B", "description": "Little Joe 5B was an uncrewed launch escape system test of the Mercury spacecraft, conducted as part of the US Mercury program.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 196, "url": "https://ll.thespacedevs.com/2.2.0/pad/196/?format=api", "agency_id": 44, "name": "Launch Area 4", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wallops_Flight_Facility", "map_url": "https://www.google.com/maps?q=37.938611,-75.457222", "latitude": "37.938611", "longitude": "-75.457222", "location": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/location/21/?format=api", "name": "Wallops Flight Facility, Virginia, USA", "country_code": "USA", "description": "Wallops Flight Facility is a rocket launch site on Wallops Island on the Eastern Shore of Virginia, United States, just east of the Delmarva Peninsula and north-northeast of Norfolk. The facility is operated by the Goddard Space Flight Center in Greenbelt, Maryland, and primarily serves to support science and exploration missions for NASA and other federal agencies. WFF includes an extensively instrumented range to support launches of more than a dozen types of sounding rockets; small expendable suborbital and orbital rockets; high-altitude balloon flights carrying scientific instruments for atmospheric and astronomical research; and, using its Research Airport, flight tests of aeronautical research aircraft, including uncrewed aerial vehicles.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_21_20200803142423.jpg", "timezone_name": "America/New_York", "total_launch_count": 80, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_area_4_20210901092808.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_image_20210901081353.jpeg", "infographic": null, "program": [ { "id": 2, "url": "https://ll.thespacedevs.com/2.2.0/program/2/?format=api", "name": "Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "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/project2520mer_program_20200820194755.png", "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 12, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 27, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
