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/f7b56f6c-4ff8-4569-bacb-d752fece8450/?format=api
{ "id": "f7b56f6c-4ff8-4569-bacb-d752fece8450", "url": "https://ll.thespacedevs.com/2.2.0/launch/f7b56f6c-4ff8-4569-bacb-d752fece8450/?format=api", "slug": "atlas-v-551-ussf-51", "flightclub_url": "https://flightclub.io/result?llId=f7b56f6c-4ff8-4569-bacb-d752fece8450", "r_spacex_api_id": null, "name": "Atlas V 551 | USSF-51", "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-07-31T14:29:48Z", "updates": [ { "id": 8178, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://newsroom.ulalaunch.com/releases/united-launch-alliance-successfully-launches-100th-national-security-mission", "created_by": "Cosmic_Penguin", "created_on": "2024-07-30T23:08:34Z" }, { "id": 8174, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=uhfwTfUseVw", "created_by": "Cosmic_Penguin", "created_on": "2024-07-30T10:45:18Z" }, { "id": 8173, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by United Launch Alliance has started", "info_url": "https://www.youtube.com/watch?v=uhfwTfUseVw", "created_by": "LL2", "created_on": "2024-07-30T10:21:06Z" }, { "id": 8172, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch weather.", "info_url": "https://x.com/ulalaunch/status/1818198533465342032", "created_by": "Cosmic_Penguin", "created_on": "2024-07-30T08:15:55Z" }, { "id": 8166, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Weather 80% GO", "info_url": "https://www.patrick.spaceforce.mil//Portals/14/Weather/Atlas%20V%20USSF-51%20L-1%20Forecast%20-%2030%20Jul%20Launch.pdf", "created_by": "hitura-nobad", "created_on": "2024-07-29T13:39:14Z" }, { "id": 8131, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://x.com/ulalaunch/status/1816837741792874836", "created_by": "Cosmic_Penguin", "created_on": "2024-07-26T14:30:32Z" }, { "id": 8126, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch window.", "info_url": "https://www.fly.faa.gov/adv/adv_spt.jsp", "created_by": "Cosmic_Penguin", "created_on": "2024-07-25T21:45:10Z" }, { "id": 7990, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting July 30", "info_url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-ussf-51/", "created_by": "Nosu", "created_on": "2024-07-01T19:24:03Z" }, { "id": 6760, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Will launch after Starliner CFT NET April.", "info_url": "https://twitter.com/ulalaunch/status/1760333992996249638", "created_by": "Cosmic_Penguin", "created_on": "2024-02-21T16:11:53Z" }, { "id": 5556, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET March 2024", "info_url": "https://spacenews.com/space-force-assigns-21-national-security-missions-to-ula-and-spacex/", "created_by": "Nosu", "created_on": "2023-10-31T19:28:47Z" }, { "id": 5148, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch vehicle configuration.", "info_url": "https://www.ssc.spaceforce.mil/LinkClick.aspx?fileticket=y-b2Aw7nHzk%3d&portalid=3", "created_by": "Cosmic_Penguin", "created_on": "2023-09-13T04:14:54Z" }, { "id": 5054, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET early 2024", "info_url": "https://www.youtube.com/watch?v=kNpxpRtHRBw&t=940s", "created_by": "Nosu", "created_on": "2023-09-02T09:02:52Z" }, { "id": 4777, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2023, to be determined.", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2023-08-05T02:10:29Z" }, { "id": 3770, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Q3 2023", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2023-04-10T15:52:39Z" }, { "id": 2696, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Q2 2023", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-10-27T04:27:36Z" }, { "id": 7904, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July.", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2024-06-21T18:45:43Z" } ], "net": "2024-07-30T10:45:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2024-07-30T15:45:00Z", "window_start": "2024-07-30T10:45:00Z", "probability": 85, "weather_concerns": "Cumulus Cloud Rule , Anvil Cloud Rules", "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": 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": 2742, "configuration": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/27/?format=api", "name": "Atlas V 551", "active": true, "reusable": false, "description": "Atlas V is an expendable launch system in the Atlas rocket family. It was formerly operated by Lockheed Martin and is now operated by United Launch Alliance (ULA), a joint venture with Boeing. Each Atlas V rocket uses a Russian-built RD-180 engine burning kerosene and liquid oxygen to power its first stage and an American-built RL10 engine burning liquid hydrogen and liquid oxygen to power its Centaur upper stage. The RD-180 engines are provided by RD Amross, while Aerojet Rocketdyne provides both the RL10 engines and the strap-on boosters used in some configurations. The standard payload fairing sizes are 4 or 5 meters in diameter and of various lengths. Fairings sizes as large as 7.2 m in diameter and up to 32.3 m in length have been considered. The rocket is assembled in Decatur, Alabama and Harlingen, Texas.", "family": "Atlas", "full_name": "Atlas V 551", "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": "551", "alias": "", "min_stage": 1, "max_stage": 2, "length": 59.7, "diameter": 3.8, "maiden_flight": "2006-01-19", "launch_cost": "153000000", "launch_mass": 573, "leo_capacity": 18850, "gto_capacity": 8890, "to_thrust": 12269, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520551_image_20190224012316.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V?wprov=sfla1", "total_launch_count": 15, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 0, "pending_launches": 8, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6154, "name": "USSF-51", "description": "Classified payload for the US Space Force.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" }, "agencies": [ { "id": 1041, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api", "name": "United States Space Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USSF", "description": "The United States Space Force (USSF) is the space service branch of the U.S. Armed Forces, one of the eight U.S. uniformed services.", "administrator": null, "founding_year": "2019", "launchers": "", "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": "https://www.spaceforce.mil/", "wiki_url": "https://en.wikipedia.org/wiki/United_States_Space_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520space2520force_logo_20221102113048.png", "image_url": null, "nation_url": null } ], "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": 1022, "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": [ { "priority": 10, "source": "www.ulalaunch.com", "title": "Atlas V USSF-51", "description": "The spacecraft is encapsulated in a 17-ft (5-m) diameter short payload fairing produced in the advanced Out-of-Autoclave manufacturing process. The 5-m PLF is a sandwich composite structure made with a vented aluminum-honeycomb core and graphite-epoxy face sheets. The bisector (two-piece shell) PLF ...", "feature_image": null, "url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-ussf-51/", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "United Launch Alliance", "title": "YouTube", "description": "Enjoy the videos and music you love, upload original content, and share it all with friends, family, and the world on YouTube.", "feature_image": null, "url": "https://www.youtube.com/watch?v=uhfwTfUseVw", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-07-30T10:20:47Z", "end_time": "2024-07-30T10:50:58Z" } ], "webcast_live": false, "timeline": [ { "type": { "id": 9, "abbrev": "Ignition", "description": "Start of the engine ignition sequence" }, "relative_time": "-PT2S" }, { "type": { "id": 25, "abbrev": "Supersonic", "description": "Vehicle is supersonic" }, "relative_time": "PT35S" }, { "type": { "id": 11, "abbrev": "Max-Q", "description": "Maximum dynamic pressure" }, "relative_time": "PT47S" }, { "type": { "id": 10, "abbrev": "Liftoff", "description": "First upwards movement of the rocket" }, "relative_time": "PT1M" }, { "type": { "id": 111, "abbrev": "Boosters Separation", "description": "Separation of the side boosters" }, "relative_time": "PT1M45S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT3M13S" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520551_image_20190224012316.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6727, "location_launch_attempt_count": 966, "pad_launch_attempt_count": 113, "agency_launch_attempt_count": 163, "orbital_launch_attempt_count_year": 138, "location_launch_attempt_count_year": 39, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P54DT19H52M45S", "mission_patches": [ { "id": 743, "name": "US Space Force Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/us2520space25_mission_patch_20221102113104.png", "agency": { "id": 1041, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api", "name": "United States Space Force", "type": "Government" } } ], "type": "detailed" }
