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/7e2d0fe7-6156-442d-be4e-cbac85f259e5/?format=api
{ "id": "7e2d0fe7-6156-442d-be4e-cbac85f259e5", "url": "https://ll.thespacedevs.com/2.2.0/launch/7e2d0fe7-6156-442d-be4e-cbac85f259e5/?format=api", "slug": "atlas-v-401-lucy", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 401 | Lucy", "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-12-31T12:31:57Z", "updates": [ { "id": 887, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful launch of NASA's Lucy probe on a 12-year journey to study the Trojan asteroids.", "info_url": "https://twitter.com/NASASolarSystem/status/1449331552161173504", "created_by": "Nosu", "created_on": "2021-10-16T11:11:17Z" }, { "id": 866, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch time confirmed by ULA", "info_url": "https://twitter.com/ulalaunch/status/1447214654707666949", "created_by": "Nosu", "created_on": "2021-10-11T17:42:51Z" }, { "id": 560, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2021-06-03T02:46:18Z" } ], "net": "2021-10-16T09:34:00Z", "net_precision": null, "window_end": "2021-10-16T10:49:00Z", "window_start": "2021-10-16T09:34:00Z", "probability": 90, "weather_concerns": null, "holdreason": "", "failreason": "", "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": 2209, "configuration": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/16/?format=api", "name": "Atlas V 401", "active": true, "reusable": false, "description": "An Atlas V with a 4 meter diameter fairing, no boosters and a single centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 401", "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": "401", "alias": "", "min_stage": 2, "max_stage": 2, "length": 58.3, "diameter": 3.8, "maiden_flight": "2002-08-21", "launch_cost": "115000000", "launch_mass": 590, "leo_capacity": 9050, "gto_capacity": 4950, "to_thrust": 3827, "apogee": 40000, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V", "total_launch_count": 41, "consecutive_successful_launches": 41, "successful_launches": 41, "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": 5849, "name": "Lucy", "description": "Lucy is the first mission to explore and study Trojan asteroids. The Trojans are a type of asteroids that orbit the Sun in two groups, in front of and behind Jupiter in its orbit around our star. Since these asteroids have been in such stable orbits for billions of years, they are of great interest as remnants of early Solar System.\r\nLucy is a NASA mission led by NASA Goddard and Southwest Research Institute in Boulder, Colorado. Over the course of 12 years, Lucy will fly by seven different Trojan asteroids and also one main belt asteroid. The complex trajectory to visit all targets will include several Earth gravity assists.", "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": 952, "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": "Lucy: The First Mission to the Trojan Asteroids", "description": "Lucy will be the first space mission to study Jupiter's Trojan asteroids. The Trojans may be remnants of the primordial material that formed the outer planets, and serve as time capsules from the birth of our solar system more than 4 billion years ago.", "feature_image": null, "url": "https://www.nasa.gov/mission_pages/lucy/overview/index", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Atlas V Lucy", "description": "Atlas V Lucy with initial coverage and post coverage cutThumbnail Photo Credit: ULA", "feature_image": "https://i.ytimg.com/vi/KC6Ms53wiBs/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=KC6Ms53wiBs", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Launch of NASA's Lucy Mission to Jupiter's Trojan Asteroids", "description": "Set a reminder: Our Lucy mission is scheduled to launch on Sat., Oct. 16 at 5:34 a.m. EDT (9:34 UTC) to ancient asteroids called Trojans.The Trojan asteroids...", "feature_image": "https://i.ytimg.com/vi/Oq5UNqtN1a8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=Oq5UNqtN1a8", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "infographic": null, "program": [ { "id": 33, "url": "https://ll.thespacedevs.com/2.2.0/program/33/?format=api", "name": "Discovery Program", "description": "The Discovery Program is a series of Solar System exploration missions funded by the U.S. National Aeronautics and Space Administration (NASA) through its Planetary Missions Program Office. The cost of each mission is capped at a lower level than missions from NASA's New Frontiers or Flagship Programs. As a result, Discovery missions tend to be more focused on a specific scientific goal rather than serving a general purpose.", "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/discovery2520p_program_20231231122246.jpeg", "start_date": "1990-01-01T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/planetarymissions/discovery-program/", "wiki_url": "https://en.wikipedia.org/wiki/Discovery_Program", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 6126, "location_launch_attempt_count": 826, "pad_launch_attempt_count": 101, "agency_launch_attempt_count": 147, "orbital_launch_attempt_count_year": 100, "location_launch_attempt_count_year": 15, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P150DT15H57M", "mission_patches": [ { "id": 87, "name": "Lucy NASA Mission Patch", "priority": 8, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/mission_patch_images/lucy2520nasa2_mission_patch_20210917111719.png", "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } } ], "type": "detailed" }
