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/73ae8553-cc90-46e9-9a01-70a712493856/?format=api
{ "id": "73ae8553-cc90-46e9-9a01-70a712493856", "url": "https://ll.thespacedevs.com/2.2.0/launch/73ae8553-cc90-46e9-9a01-70a712493856/?format=api", "slug": "starship-sn15-10-km-flight", "flightclub_url": null, "r_spacex_api_id": "6079bd1c9a06446e8c61bf76", "name": "Starship SN15 | 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:17:54Z", "updates": [ { "id": 500, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful launch and landing of Starship SN15.", "info_url": "https://twitter.com/elonmusk/status/1390073153347592192", "created_by": "Nosu", "created_on": "2021-05-05T22:38:06Z" }, { "id": 499, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Starship SN15 launch attempt at approximately 22:20 UTC, per SpaceX stream.", "info_url": "https://www.youtube.com/watch?v=z9eoubnO-pE", "created_by": "Nosu", "created_on": "2021-05-05T21:48:45Z" }, { "id": 498, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/altrius_profile_20210324100500.png", "comment": "Road has been opened, Starship SN15 flight still possible towards the end of the window.", "info_url": "https://www.youtube.com/watch?v=sTA0GTgFn5E", "created_by": "Altrius", "created_on": "2021-05-05T20:25:06Z" }, { "id": 494, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/altrius_profile_20210324100500.png", "comment": "No evacuation notice for today. Starship SN15 flight NET May 5.", "info_url": "https://twitter.com/BocaChicaGal/status/1389605525608927233", "created_by": "Altrius", "created_on": "2021-05-04T16:02:31Z" }, { "id": 497, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/koun7erfit_profile_20210817212350.png", "comment": "Everything is very subject to change - however Boca Chica village is evacuated, road closed and all is looking good for an attempt today.", "info_url": null, "created_by": "Koun7erfit", "created_on": "2021-05-05T17:38:40Z" }, { "id": 491, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/koun7erfit_profile_20210817212350.png", "comment": "May the 4th is shaping up to be a good opportunity - weather seems to be good, road closures and residents have been notified. Stay tuned tomorrow!", "info_url": "https://twitter.com/BocaChicaGal/status/1389354107253805060", "created_by": "Koun7erfit", "created_on": "2021-05-04T02:59:02Z" }, { "id": 486, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Road closure cancelled for today. Starship SN15 flight NET Monday.", "info_url": "https://www.cameroncounty.us/spacex/", "created_by": "Nosu", "created_on": "2021-04-30T17:48:57Z" } ], "net": "2021-05-05T22:24:00Z", "net_precision": null, "window_end": "2021-05-06T01:00:00Z", "window_start": "2021-05-05T17: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": 498, "consecutive_successful_launches": 21, "successful_launches": 484, "failed_launches": 14, "pending_launches": 119, "consecutive_successful_landings": 67, "successful_landings": 445, "failed_landings": 26, "attempted_landings": 470, "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": 2852, "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": 498, "consecutive_successful_launches": 21, "successful_launches": 484, "failed_launches": 14, "pending_launches": 119, "consecutive_successful_landings": 67, "successful_landings": 445, "failed_landings": 26, "attempted_landings": 470, "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": 171, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 94, "url": "https://ll.thespacedevs.com/2.2.0/launcher/94/?format=api", "details": "Next Starship prototype built after SN11. It features hundreds of design improvements across structures, avionics, software and engine.\r\nFirst Starship prototype to successfully land after a high altitude flight.", "flight_proven": true, "serial_number": "SN15", "status": "retired", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/94_image_20210511112730.jpeg", "successful_landings": 1, "attempted_landings": 1, "flights": 1, "last_launch_date": "2021-05-05T22:24:00Z", "first_launch_date": "2021-05-05T22:24:00Z" }, "landing": { "id": 202, "attempt": true, "success": true, "description": "Starship SN15 successfully landed back at the launch site after its high-altitude flight.", "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": 1266, "name": "10 km Flight", "description": "The SN15 Starship prototype will perform a test flight similar to SN8 to SN11. It will launch up to an altitude of 10 km or 33,000 ft and do a belly flop maneuver followed by a controlled descent to the landing pad.", "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-sn15-flight-test", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Starship SN15", "description": "Starship SN15 with initial coverage and post coverage cutThumbnail Photo Credit: SpaceX", "feature_image": "https://i.ytimg.com/vi/xPvyl2YyjLE/maxresdefault.jpg", "url": "https://youtu.be/xPvyl2YyjLE", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 1, "source": null, "publisher": null, "title": "Starship | SN15 | High-Altitude Flight Test", "description": "As early as Wednesday, May 5, the SpaceX team will attempt a high-altitude flight test of Starship serial number 15 (SN15) – our fifth high-altitude flight t...", "feature_image": "https://i.ytimg.com/vi/z9eoubnO-pE/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=z9eoubnO-pE", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "Nerdle Cam 4K- SpaceX Starship Launch Facility", "description": "SUNDAY 4/18/2021 Welcome to the LabPadre 24/7 Livestream! || Onsite weather provided by INITWeather.com || BOCA CHICA NEWS: NO LAUNCH TODAY! Raptor #'s 54, 6...", "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": 10, "source": null, "publisher": null, "title": "LIVE: Starship SN15 Flight Test", "description": "SpaceX is performing a test flight of Starship SN15. The prototype will aim to be the first Starship vehicle to softly land during a high altitude flight tes...", "feature_image": "https://i.ytimg.com/vi/NPNvB5ComFw/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=NPNvB5ComFw", "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": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/starship2520sn_infographic_20210504025610.jpeg", "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": 9, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 134, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 17, "pad_turnaround": "P62DT23H9M", "mission_patches": [], "type": "detailed" }
