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/c0ac9a61-5aac-40d7-9919-3c29ea7d4172/?format=api
{ "id": "c0ac9a61-5aac-40d7-9919-3c29ea7d4172", "url": "https://ll.thespacedevs.com/2.2.0/launch/c0ac9a61-5aac-40d7-9919-3c29ea7d4172/?format=api", "slug": "starship-sn10-10-km-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Starship SN10 | 10 km Flight", "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:07:49Z", "updates": [ { "id": 329, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful flight overall, but SN10 landed too hard resulting in a RUD a few minutes after touchdown.", "info_url": "https://www.youtube.com/watch?v=ODY6JWzS8WU", "created_by": "Nosu", "created_on": "2021-03-03T23:23:27Z" }, { "id": 328, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Currently targeting 23:13 UTC", "info_url": "https://twitter.com/joroulette/status/1367242789029773314?s=20", "created_by": "Nosu", "created_on": "2021-03-03T22:40:09Z" }, { "id": 327, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Second attempt confirmed", "info_url": "https://twitter.com/elonmusk/status/1367213114228318209", "created_by": "Nosu", "created_on": "2021-03-03T20:41:47Z" }, { "id": 326, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Second attempt possible in 2 hours.", "info_url": "https://www.youtube.com/watch?v=DDEgFsefrGw", "created_by": "Nosu", "created_on": "2021-03-03T20:33:48Z" }, { "id": 325, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Abort at ignition. Standing by for a possible second attempt today.", "info_url": "https://twitter.com/SpacePadreIsle/status/1367207329024905217", "created_by": "Nosu", "created_on": "2021-03-03T20:21:04Z" }, { "id": 324, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Currently targeting 20:14 UTC", "info_url": "https://twitter.com/thesheetztweetz/status/1367199945942564866", "created_by": "Nosu", "created_on": "2021-03-03T19:49:46Z" }, { "id": 323, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Current targeted T-0 is 15:54 UTC", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=52924.msg2198989#msg2198989", "created_by": "SwGustav", "created_on": "2021-03-03T14:12:40Z" }, { "id": 319, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Potential flight attempt after the evacuation notices given out", "info_url": "https://twitter.com/BocaChicaGal/status/1366831841509056512", "created_by": "SwGustav", "created_on": "2021-03-02T19:48:15Z" }, { "id": 314, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "SN10 NET than Wednesday. Setting TBD until the evacuation notice is given to residents.", "info_url": "https://twitter.com/bocachicagal/status/1366189604001488901?s=21", "created_by": "Nosu", "created_on": "2021-03-01T07:58:19Z" }, { "id": 307, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Road closure cancelled for today. Flight NET Monday March 1.", "info_url": "https://www.cameroncounty.us/spacex/", "created_by": "Nosu", "created_on": "2021-02-26T07:12:01Z" }, { "id": 306, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Second static fire complete. Flight NET tomorrow (February 26).", "info_url": null, "created_by": "Nosu", "created_on": "2021-02-25T23:00:35Z" }, { "id": 300, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "After a first static fire, Starship SN10 is now expected to fly as early as February 25.", "info_url": "https://tfr.faa.gov/save_pages/detail_1_6333.html", "created_by": "Nosu", "created_on": "2021-02-23T23:16:47Z" }, { "id": 304, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Road closure cancelled for today (Feb 24). Pushing the second static fire and the flight to February 25 and 26 respectively.", "info_url": "https://www.cameroncounty.us/spacex/", "created_by": "Nosu", "created_on": "2021-02-24T14:13:48Z" }, { "id": 302, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "One engine of SN10 will be swapped out and a new static fire attempted on February 24. Flight NET February 25 pending a successful static fire.", "info_url": "https://twitter.com/elonmusk/status/1364473175279620096?s=20", "created_by": "Nosu", "created_on": "2021-02-24T07:19:57Z" }, { "id": 312, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Evacuation announced, potential hop attempt", "info_url": "https://twitter.com/BocaChicaGal/status/1366141446999449603/", "created_by": "SwGustav", "created_on": "2021-02-28T21:53:35Z" } ], "net": "2021-03-03T23:15:00Z", "net_precision": null, "window_end": "2021-03-04T00:00:00Z", "window_start": "2021-03-03T15:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 488, "consecutive_successful_launches": 11, "successful_launches": 474, "failed_launches": 14, "pending_launches": 108, "consecutive_successful_landings": 57, "successful_landings": 435, "failed_landings": 26, "attempted_landings": 460, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "rocket": { "id": 2832, "configuration": { "id": 207, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/207/?format=api", "name": "Starship Prototype", "active": false, "reusable": true, "description": "Prototype of SpaceX's Starship, a fully reusable second stage and space vehicle.", "family": "Starship", "full_name": "Starship Prototype", "manufacturer": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 488, "consecutive_successful_launches": 11, "successful_launches": 474, "failed_launches": 14, "pending_launches": 108, "consecutive_successful_landings": 57, "successful_landings": 435, "failed_landings": 26, "attempted_landings": 460, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "program": [ { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/program/1/?format=api", "name": "SpaceX Starship", "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project. The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.", "agencies": [ { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex2520star_program_20201129204513.png", "start_date": "2019-03-01T05:00:00Z", "end_date": null, "info_url": "https://www.spacex.com/vehicles/starship/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship", "mission_patches": [], "type": { "id": 7, "name": "Technology" } } ], "variant": "Prototype", "alias": "", "min_stage": 1, "max_stage": 1, "length": 50.0, "diameter": 9.0, "maiden_flight": "2019-07-26", "launch_cost": null, "launch_mass": 45, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship2520sn_image_20210413205503.jpeg", "info_url": "https://www.spacex.com/vehicles/starship/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship", "total_launch_count": 9, "consecutive_successful_launches": 1, "successful_launches": 6, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 9, "successful_landings": 5, "failed_landings": 4, "consecutive_successful_landings": 1 }, "launcher_stage": [ { "id": 164, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 91, "url": "https://ll.thespacedevs.com/2.2.0/launcher/91/?format=api", "details": "SN10 is a Starship Prototype similar in design to SN9. SN10 was destroyed during an explosion on the pad after landing.", "flight_proven": true, "serial_number": "SN10", "status": "destroyed", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/91_image_20210303201919.jpg", "successful_landings": 0, "attempted_landings": 1, "flights": 1, "last_launch_date": "2021-03-03T23:15:00Z", "first_launch_date": "2021-03-03T23:15:00Z" }, "landing": { "id": 195, "attempt": true, "success": false, "description": "SN10 performed a hard landing on the pad damaging its structure and resulting in an explosive destruction a few minutes later.", "downrange_distance": 0.15, "location": { "id": 14, "name": "SpaceX Starship Landing Pad", "abbrev": "LZ", "description": "This is the landing pad used for early Starship development flights.", "location": { "id": 143, "url": "https://ll.thespacedevs.com/2.2.0/location/143/?format=api", "name": "SpaceX Starbase, TX, USA", "country_code": "USA", "description": "Starbase is an industrial complex for Starship rockets and the headquarters of the American aerospace manufacturer company SpaceX. Located near Brownsville, Texas, United States, it has been under construction since the late 2010s by SpaceX. Starbase is composed of a spaceport near the Gulf of Mexico, a production facility at the Boca Chica village, and a small structure test site along the Texas State Highway 4.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg", "timezone_name": "America/Chicago", "total_launch_count": 17, "total_landing_count": 13 }, "successful_landings": 5 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 1239, "name": "10 km Flight", "description": "The SN10 Starship performed a test flight similar to SN8 and SN9. It launched up to an altitude of 10 km or 33,000 ft, did a belly flop maneuver followed by a controlled descent to the landing pad. Despite successfully performing the landing flip maneuver with its three Raptor engines, its vertical velocity was too high on landing, damaging its structure and resulting in an explosive destruction a few minutes after touchdown.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/pad/111/?format=api", "agency_id": 121, "name": "Suborbital Pad A", "description": "Suborbital Pad A was used for Starhopper flights, the SN5 and SN6 hops, as well as multiple Starship high altitude flight tests. It was demolished at the end of 2023, to make room for a second orbital pad.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_South_Texas_Launch_Site", "map_url": "https://www.google.com/maps?q=25.997116,-97.15503099856647", "latitude": "25.997116", "longitude": "-97.15503099856647", "location": { "id": 143, "url": "https://ll.thespacedevs.com/2.2.0/location/143/?format=api", "name": "SpaceX Starbase, TX, USA", "country_code": "USA", "description": "Starbase is an industrial complex for Starship rockets and the headquarters of the American aerospace manufacturer company SpaceX. Located near Brownsville, Texas, United States, it has been under construction since the late 2010s by SpaceX. Starbase is composed of a spaceport near the Gulf of Mexico, a production facility at the Boca Chica village, and a small structure test site along the Texas State Highway 4.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg", "timezone_name": "America/Chicago", "total_launch_count": 17, "total_landing_count": 13 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_111_20200803143229.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 0 }, "infoURLs": [ { "priority": 10, "source": null, "title": "", "description": "SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.", "feature_image": null, "url": "https://www.spacex.com/launches/starship-sn10-flight-test/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Starship SN10 10km Flight", "description": "Full flight of Starship 10 with breaks cut out", "feature_image": "https://i.ytimg.com/vi/avsfC3EyFCQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=avsfC3EyFCQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 6, "source": null, "publisher": null, "title": "Starship | SN10 | High-Altitude Flight Test", "description": "As early as Wednesday, March 3, the SpaceX team will attempt a high-altitude flight test of Starship serial number 10 (SN10) – our third high-altitude suborb...", "feature_image": "https://i.ytimg.com/vi/ODY6JWzS8WU/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=ODY6JWzS8WU", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 7, "source": null, "publisher": null, "title": "Nerdle Cam 4K- SpaceX SN10 At Boca Chica Starship Launch Facility", "description": "SN10 LAUNCH EXPECTED TODAY - WEDNESDAY 3/03/2021 Welcome to the LabPadre 24/7 Livestream! || Onsite weather provided by INITWeather.com || BOCA CHICA NEWS: S...", "feature_image": "https://i.ytimg.com/vi/sTA0GTgFn5E/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=sTA0GTgFn5E", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 8, "source": null, "publisher": null, "title": "Starship | SN10 | High-Altitude Flight Test", "description": "As early as Wednesday, March 3, the SpaceX team will attempt a high-altitude flight test of Starship serial number 10 (SN10) – our third high-altitude suborb...", "feature_image": "https://i.ytimg.com/vi/DDEgFsefrGw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=DDEgFsefrGw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "LIVE: Starship SN10 Flight Test", "description": "SpaceX is set to launch the Starship SN10 prototype to an altitude of approximately 10 kilometers. A launch attempt is possible between 9 am and 6 pm Central...", "feature_image": "https://i.ytimg.com/vi/XOQkk3ojNfM/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=XOQkk3ojNfM", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Watch SpaceX launch Starship SN10, at the edge of the exclusion zone!", "description": "Starship SN10 will be attempting a medium altitude test flight (~10 km). It will lift off from Boca Chica, Texas under the power of three Raptor engines. At ...", "feature_image": "https://i.ytimg.com/vi/_jWbqhP5eJI/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=_jWbqhP5eJI", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship2520sn_image_20210413205503.jpeg", "infographic": null, "program": [ { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/program/1/?format=api", "name": "SpaceX Starship", "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project. The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.", "agencies": [ { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex2520star_program_20201129204513.png", "start_date": "2019-03-01T05:00:00Z", "end_date": null, "info_url": "https://www.spacex.com/vehicles/starship/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship", "mission_patches": [], "type": { "id": 7, "name": "Technology" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 7, "pad_launch_attempt_count": 6, "agency_launch_attempt_count": 124, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 7, "pad_turnaround": "P84DT29M35S", "mission_patches": [], "type": "detailed" }
