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/060fc260-01bd-41ec-a0be-ce2223fbbc76/?format=api
{ "id": "060fc260-01bd-41ec-a0be-ce2223fbbc76", "url": "https://ll.thespacedevs.com/2.2.0/launch/060fc260-01bd-41ec-a0be-ce2223fbbc76/?format=api", "slug": "atlas-v-401-jpss-2-joint-polar-satellite-system-sp", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 401 | JPSS 2 (Joint Polar Satellite System spacecraft No. 2) & LOFTID", "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:25:13Z", "updates": [ { "id": 2794, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Successful deployment and health confirmation of JPSS 2; successful separation of LOFTID thus completing the launch vehicle's mission", "info_url": "https://www.youtube.com/watch?v=7eSn9_v9Q_8", "created_by": "SwGustav", "created_on": "2022-11-10T11:05:38Z" }, { "id": 2793, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff", "info_url": "https://youtu.be/7eSn9_v9Q_8", "created_by": "Cosmic_Penguin", "created_on": "2022-11-10T09:49:44Z" }, { "id": 2792, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=7eSn9_v9Q_8", "created_by": "SwGustav", "created_on": "2022-11-10T09:49:23Z" }, { "id": 2791, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Hold released", "info_url": "https://twitter.com/ulalaunch/status/1590636796395737088", "created_by": "Cosmic_Penguin", "created_on": "2022-11-10T09:27:26Z" }, { "id": 2790, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "New T-0", "info_url": "https://twitter.com/ulalaunch/status/1590636796395737088", "created_by": "SwGustav", "created_on": "2022-11-10T09:27:14Z" }, { "id": 2789, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Extended hold due to Centaur valve issue.", "info_url": "https://twitter.com/ulalaunch/status/1590633647941767170", "created_by": "Cosmic_Penguin", "created_on": "2022-11-10T09:15:34Z" }, { "id": 2788, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Coverage live", "info_url": "https://www.youtube.com/watch?v=7eSn9_v9Q_8", "created_by": "SwGustav", "created_on": "2022-11-10T08:46:49Z" }, { "id": 2746, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for November 10", "info_url": "https://twitter.com/ulalaunch/status/1588274281389215746", "created_by": "Cosmic_Penguin", "created_on": "2022-11-04T02:21:43Z" }, { "id": 2712, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET November 9", "info_url": "https://twitter.com/ulalaunch/status/1586427367257296896", "created_by": "Cosmic_Penguin", "created_on": "2022-10-29T18:40:22Z" }, { "id": 2711, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Weather 40% GO per prelaunch press briefing", "info_url": "https://www.youtube.com/watch?v=phRnHhLRNEg&t=1528s", "created_by": "Jay", "created_on": "2022-10-29T13:28:40Z" }, { "id": 2564, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch window", "info_url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-jpss-2", "created_by": "Cosmic_Penguin", "created_on": "2022-10-10T03:12:22Z" }, { "id": 1810, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET November 1", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-06-04T08:37:57Z" } ], "net": "2022-11-10T09:49:00Z", "net_precision": null, "window_end": "2022-11-10T10:01:00Z", "window_start": "2022-11-10T09:25:00Z", "probability": 95, "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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "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": 185, "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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "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": "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://thespacedevs-prod.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": 756, "name": "JPSS 2 (Joint Polar Satellite System spacecraft No. 2) & LOFTID", "description": "JPSS is a collaborative program between NOAA and NASA. JPSS-2 is one of five satellites that will comprise the JPSS constellation. These spacecraft gather global measurements of atmospheric, terrestrial and oceanic conditions, including sea and land surface temperatures, vegetation, clouds, rainfall, snow and ice cover, fire locations and smoke plumes, atmospheric temperature, water vapor and ozone.\r\n\r\nLOFTID is a tech demo for the inflatable heatshield technology. It will attempt to survive a reentry from orbit after JPSS 2 is separated. This test will validate the technology for various applications, such as landing large payloads on Mars and engine reuse on ULA’s Vulcan rocket.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/pad/24/?format=api", "agency_id": 161, "name": "Space Launch Complex 3E", "description": "SLC-3E is a launch pad at Vandenberg Space Force Base. It was originally built for the MIDAS program and later used for various other missions. After a period of inactivity, it was refurbished in the early 2000s to launch Atlas V rockets. The pad is now being upgraded to accommodate the new Vulcan Centaur rocket. The last Atlas V launch from SLC-3E happened in November 2022, with the first Vulcan launch expected in 2025.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_3#SLC-3E", "map_url": "https://www.google.com/maps?q=34.64,-120.5895", "latitude": "34.64", "longitude": "-120.5895", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 797, "total_landing_count": 26 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_24_20200803143552.jpg", "total_launch_count": 48, "orbital_launch_attempt_count": 45 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Launch of JPSS-2 Weather Satellite & LOFTID Mars Tech Demo (Official NASA Broadcast)", "description": "Watch live as a new weather forecasting satellite and experimental Mars technology take to the skies. The National Oceanic and Atmospheric Administration (NO...", "feature_image": "https://i.ytimg.com/vi/7eSn9_v9Q_8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=7eSn9_v9Q_8", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "infographic": null, "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://thespacedevs-prod.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": 6337, "location_launch_attempt_count": 707, "pad_launch_attempt_count": 48, "agency_launch_attempt_count": 156, "orbital_launch_attempt_count_year": 155, "location_launch_attempt_count_year": 14, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P408DT15H37M", "mission_patches": [ { "id": 745, "name": "JPSS Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/jpss2520patch_mission_patch_20221107214119.png", "agency": { "id": 210, "url": "https://ll.thespacedevs.com/2.2.0/agencies/210/?format=api", "name": "National Oceanic and Atmospheric Administration", "type": "Government" } } ], "type": "detailed" }
