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/c4db6995-f25f-4608-8eb9-ce95d5226af2/?format=api
{ "id": "c4db6995-f25f-4608-8eb9-ce95d5226af2", "url": "https://ll.thespacedevs.com/2.2.0/launch/c4db6995-f25f-4608-8eb9-ce95d5226af2/?format=api", "slug": "atlas-v-541-mars-2020-perseverance-rover-ingenuity", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 541 | Mars 2020 (Perseverance rover & Ingenuity helicopter)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-05T18:12:01Z", "updates": [], "net": "2020-07-30T11:50:00Z", "net_precision": null, "window_end": "2020-07-30T13:50:00Z", "window_start": "2020-07-30T11:50:00Z", "probability": 90, "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": 161, "consecutive_successful_launches": 161, "successful_launches": 161, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 157, "configuration": { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/1/?format=api", "name": "Atlas V 541", "active": true, "reusable": false, "description": "Atlas V with 5m Fairing, 4 SRB, 1 Centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 541", "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": 161, "consecutive_successful_launches": 161, "successful_launches": 161, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "541", "alias": "", "min_stage": 0, "max_stage": 2, "length": 60.0, "diameter": 3.8, "maiden_flight": "2011-11-26", "launch_cost": "145000000", "launch_mass": 479, "leo_capacity": 17410, "gto_capacity": 8290, "to_thrust": null, "apogee": 40000, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520541_image_20190224012314.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": null, "total_launch_count": 9, "consecutive_successful_launches": 9, "successful_launches": 9, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1126, "name": "Mars 2020 (Perseverance rover & Ingenuity helicopter)", "description": "Atop this ULA Atlas V rocket will be Perseverance, a car-sized rover which will explore an ancient river delta on Mars. Armed with a suite of six scientific instruments, Perseverance will primarily hunt for clues to the planet's distant past, and hopefully uncover signs of ancient life and habitability. The rover also carries an experiment that'll convert carbon dioxide into oxygen, a box-sized helicopter named Ingenuity that'll demonstrate powered flight on Mars, and a system that enables the rover to leave behind samples for later retrieval and return to Earth during NASA and ESA's ambitious sample return mission later this decade.", "launch_designator": null, "type": "Robotic Exploration", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" }, "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": null, "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, FL, USA", "country_code": "USA", "description": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 949, "total_landing_count": 51 }, "country_code": "USA", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_29_20200803143528.jpg", "total_launch_count": 111, "orbital_launch_attempt_count": 111 }, "infoURLs": [ { "priority": 10, "source": null, "title": "Atlas V Perseverance- United Launch Alliance (ULA) Rocket Launch", "description": "A United Launch Alliance Atlas V 541 rocket will launch NASA's Perseverance rover to Mars.", "feature_image": null, "url": "https://www.ulalaunch.com/missions/atlas-v-mars-2020", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Atlas V Mars 2020 Launch Highlights", "description": "A United Launch Alliance (ULA) Atlas V rocket carrying the Mars 2020 mission with the Perseverance rover for NASA, lifted off from Space Launch Complex-41 on...", "feature_image": "https://i.ytimg.com/vi/keCc0_8QfL8/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=keCc0_8QfL8", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Watch Our Perseverance Rover Launch to Mars!", "description": "Was there once life on Mars? Our Perseverance rover aims to find out! On Thursday, July 30, watch our new robotic astrobiologist launch on a seven-month jour...", "feature_image": "https://i.ytimg.com/vi/JIB3JbIIbPU/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=JIB3JbIIbPU", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/atlas2520v252_image_20200729144937.jpg", "infographic": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/atlas2520v252_infographic_20200806042150.png", "program": [ { "id": 36, "url": "https://ll.thespacedevs.com/2.2.0/program/36/?format=api", "name": "NASA Large Strategic Science Missions", "description": "NASA's large strategic science missions or large strategic missions, formerly known as Flagship missions or Flagship-class missions, are the costliest and most capable NASA science spacecraft. Flagship missions exist within all four divisions of NASA's Science Mission Directorate (SMD): the astrophysics, Earth science, heliophysics and planetary science divisions.", "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/nasa2520large_program_20240205122003.jpeg", "start_date": "1975-08-22T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Large_strategic_science_missions", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 5970, "location_launch_attempt_count": 803, "pad_launch_attempt_count": 98, "agency_launch_attempt_count": 141, "orbital_launch_attempt_count_year": 58, "location_launch_attempt_count_year": 12, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P73DT22H36M", "mission_patches": [], "type": "detailed" }
