Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/e32d375f-0d6e-4e54-b4f2-2b49db657fca/?format=api
{ "id": "e32d375f-0d6e-4e54-b4f2-2b49db657fca", "url": "https://ll.thespacedevs.com/2.0.0/launch/e32d375f-0d6e-4e54-b4f2-2b49db657fca/?format=api", "launch_library_id": null, "slug": "starship-integrated-flight-test", "name": "Starship | Integrated Flight Test", "status": { "id": 4, "name": "Failure" }, "net": "2023-04-20T13:33:09Z", "window_end": "2023-04-20T14:30:00Z", "window_start": "2023-04-20T13:28:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "After liftoff, the vehicle sustained fires from leaking propellant in the aft end of the Super Heavy booster, severing connection with the vehicle’s primary flight computer. This led to a loss of communications to most of the booster engines and eventually control of the vehicle. After the second stage failed to separate from the first stage, the vehicle reached an apogee of ~39km before tumbling downwards until the flight termination system was activated.\r\n\r\nUnexpected severe damage was also imparted on the launch pad.", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.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": 503, "consecutive_successful_launches": 26, "successful_launches": 489, "failed_launches": 14, "pending_launches": 120, "consecutive_successful_landings": 72, "successful_landings": 450, "failed_landings": 26, "attempted_landings": 475, "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": 2881, "configuration": { "id": 464, "launch_library_id": null, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/464/?format=api", "name": "Starship", "description": "Fully reusable two-stage super heavy-lift launch vehicle.", "family": "Starship", "full_name": "Starship", "manufacturer": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.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": 503, "consecutive_successful_launches": 26, "successful_launches": 489, "failed_launches": 14, "pending_launches": 120, "consecutive_successful_landings": 72, "successful_landings": 450, "failed_landings": 26, "attempted_landings": 475, "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.0.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.0.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" } ], "variant": "", "alias": "", "min_stage": 2, "max_stage": 2, "length": 120.0, "diameter": 9.0, "maiden_flight": "2023-04-20", "launch_mass": 5000, "leo_capacity": 100000, "gto_capacity": 21000, "to_thrust": 72000, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_20240314160301.jpg", "info_url": "https://www.spacex.com/vehicles/starship/index.html", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship", "total_launch_count": 8, "consecutive_successful_launches": 0, "successful_launches": 4, "failed_launches": 4, "pending_launches": 3 }, "launcher_stage": [ { "id": 263, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 115, "url": "https://ll.thespacedevs.com/2.0.0/launcher/115/?format=api", "details": "Booster 7 is the first Super Heavy booster with 33 Raptor 2 engines and was used for the first Starship integrated flight test with Ship 24. Lost in a launch failure.", "flight_proven": true, "serial_number": "Booster 7", "status": "destroyed", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/115_image_20220915030149.jpeg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2023-04-20T13:33:09Z", "first_launch_date": "2023-04-20T13:33:09Z" }, "landing": { "id": 291, "attempt": false, "success": null, "description": "Booster 7 was expected to splash down in the Gulf of Mexico following the maiden flight of Starship, but was lost in a launch failure during ascent.", "location": { "id": 16, "name": "Gulf of Mexico", "abbrev": "GOM", "description": "Gulf of Mexico", "location": null, "successful_landings": 16 }, "type": { "id": 3, "name": "Ocean", "abbrev": "Ocean", "description": "No recovery attempt" } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": { "id": 783, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/783/?format=api", "mission_end": "2023-04-20T13:37:00Z", "destination": "Pacific Ocean", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 555, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/555/?format=api", "name": "Ship 24", "serial_number": "S24", "status": { "id": 3, "name": "Destroyed" }, "description": "Ship 24 (S24) used for the first integrated flight test. Lost in a launch failure.", "spacecraft_config": { "id": 26, "url": "https://ll.thespacedevs.com/2.0.0/config/spacecraft/26/?format=api", "name": "Starship", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.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", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg" }, "in_use": true, "capability": "More than 100 tons to Earth orbit", "history": "The Starship second stage was testing during a number of low and high altitude suborbital flights before the first orbital launch attempt.", "details": "Second stage of the two-stage Starship super heavy-lift launch vehicle.", "maiden_flight": "2023-04-20", "height": 50.0, "diameter": 9.0, "human_rated": false, "crew_capacity": 0, "payload_capacity": 100000, "flight_life": "Unknown at this stage", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/SpaceX_Starship", "info_link": "https://www.spacex.com/vehicles/starship/" } }, "docking_events": [] } }, "mission": { "id": 1297, "launch_library_id": null, "name": "Integrated Flight Test", "description": "Maiden flight of the two-stage Starship launch vehicle. The booster was supposed to separate 170 seconds into flight and return to land approximately 32 km off the shore in the Gulf of Mexico. The second stage would have followed a suborbital trajectory and performed an unpowered splashdown approximately 100 km off the northwest coast of Kauai (Hawaii). A launch failure was experienced before stage separation.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" } }, "pad": { "id": 188, "url": "https://ll.thespacedevs.com/2.0.0/pad/188/?format=api", "agency_id": 121, "name": "Orbital Launch Mount A", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starbase#Launch_site_(Orbital_Launch_Pad_A_and_B)", "map_url": "https://www.google.com/maps?q=25.9962,-97.154423", "latitude": "25.9962", "longitude": "-97.154423", "location": { "id": 143, "url": "https://ll.thespacedevs.com/2.0.0/location/143/?format=api", "name": "SpaceX Starbase, TX, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg", "total_launch_count": 17, "total_landing_count": 13 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_orbital_launch_mount_a_20210514061342.jpg", "total_launch_count": 8 }, "infoURLs": [ { "priority": 9, "title": "SpaceX", "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/mission/?missionId=starship-flight-test" }, { "priority": 10, "title": "SpaceX", "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/vehicles/starship/" } ], "vidURLs": [ { "priority": 9, "title": "Starship Flight Test", "description": "SpaceX is targeting as soon as Thursday, April 20 for the first flight test of a fully integrated Starship and Super Heavy rocket from Starbase in Texas. The...", "feature_image": "https://i.ytimg.com/vi/-1wcilQ58hI/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=-1wcilQ58hI" }, { "priority": 10, "title": "Starship Flight Test", "description": "SpaceX is targeting as soon as Monday, April 17 for the first flight test of a fully integrated Starship and Super Heavy rocket from Starbase in Texas. The 1...", "feature_image": "https://i.ytimg.com/vi/L5QXreqOrTA/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=L5QXreqOrTA" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship25202_image_20230417053710.jpeg", "infographic": null, "program": [ { "id": 1, "url": "https://ll.thespacedevs.com/2.0.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.0.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" } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 10, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 239, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 26 }
