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/8e2d9e38-577b-4acb-bc01-f83385cf31bd/?format=api
{ "id": "8e2d9e38-577b-4acb-bc01-f83385cf31bd", "url": "https://ll.thespacedevs.com/2.2.0/launch/8e2d9e38-577b-4acb-bc01-f83385cf31bd/?format=api", "slug": "atlas-v-541-goes-r", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 541 | GOES-R", "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-14T17:42:18Z", "updates": [], "net": "2016-11-19T23:42:00Z", "net_precision": null, "window_end": "2016-11-19T23:42:00Z", "window_start": "2016-11-19T22:42:00Z", "probability": 100, "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": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "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://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 1966, "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": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "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://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.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://thespacedevs-prod.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": 261, "name": "GOES-R", "description": "The Geostationary Operational Environmental Satellite-R Series (GOES-R) is the next generation of geostationary weather satellites. The four satellites of the series will provide advanced imaging with increased spatial resolution and faster coverage for more accurate forecasts, real-time mapping of lightning activity, and improved monitoring of solar activity. GOES-R is the first satellite of the series, and it will provide continuous imagery and atmospheric measurements of Earth’s Western Hemisphere and space weather monitoring. It will be the primary tool for the detection and tracking of hurricanes and severe weather.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "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": "", "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 SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1023, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Atlas V GOES-R Launch Highlights", "description": "", "feature_image": "https://i.ytimg.com/vi/7AFhtNHw8Hw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=7AFhtNHw8Hw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Atlas V Lift-off for GOES-R Mission", "description": "A United Launch Alliance Atlas V rocket lifts off from Space Launch Complex 41 at Cape Canaveral Air Force Station carrying the NOAA Geostationary Operationa...", "feature_image": "https://i.ytimg.com/vi/FDhJYgcHDX8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=FDhJYgcHDX8", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520541_image_20190224012314.jpeg", "infographic": null, "program": [ { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/program/37/?format=api", "name": "Geostationary Operational Environmental Satellite", "description": "The Geostationary Operational Environmental Satellite (GOES), operated by the United States' National Oceanic and Atmospheric Administration (NOAA)'s National Environmental Satellite, Data, and Information Service division, supports weather forecasting, severe storm tracking, and meteorology research", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 210, "url": "https://ll.thespacedevs.com/2.2.0/agencies/210/?format=api", "name": "National Oceanic and Atmospheric Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/goes-u_render_image_20240623151909.jpg", "start_date": "1975-10-16T22:40:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Geostationary_Operational_Environmental_Satellite", "mission_patches": [], "type": { "id": 8, "name": "Earth Observation" } } ], "orbital_launch_attempt_count": 5602, "location_launch_attempt_count": 752, "pad_launch_attempt_count": 83, "agency_launch_attempt_count": 114, "orbital_launch_attempt_count_year": 73, "location_launch_attempt_count_year": 16, "pad_launch_attempt_count_year": 7, "agency_launch_attempt_count_year": 10, "pad_turnaround": "P72DT37M", "mission_patches": [], "type": "detailed" }
