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/16aae09d-229e-4b9e-876c-6ac31ef5678f/?format=api
{ "id": "16aae09d-229e-4b9e-876c-6ac31ef5678f", "url": "https://ll.thespacedevs.com/2.2.0/launch/16aae09d-229e-4b9e-876c-6ac31ef5678f/?format=api", "slug": "falcon-9-v11-spx-crs-7", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon 9 v1.1 | SpX CRS-7", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T17:41:18Z", "updates": [], "net": "2015-06-28T14:21:11Z", "net_precision": null, "window_end": "2015-06-28T14:21:11Z", "window_start": "2015-06-28T14:21:11Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "Rapid Unscheduled Disassembly at T+ 2min19sec after a support strut failure in the second stage.", "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": 494, "consecutive_successful_launches": 17, "successful_launches": 480, "failed_launches": 14, "pending_launches": 121, "consecutive_successful_landings": 63, "successful_landings": 441, "failed_landings": 26, "attempted_landings": 466, "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": 1850, "configuration": { "id": 14, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/14/?format=api", "name": "Falcon 9", "active": false, "reusable": false, "description": "Falcon 9 v1.1 is a significantly redesigned version of the its predecessor, including a higher payload capacity. This version arranges the engines in a structural form SpaceX calls an Octaweb.", "family": "Falcon", "full_name": "Falcon 9 v1.1", "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": 494, "consecutive_successful_launches": 17, "successful_launches": 480, "failed_launches": 14, "pending_launches": 121, "consecutive_successful_landings": 63, "successful_landings": 441, "failed_landings": 26, "attempted_landings": 466, "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": 11, "url": "https://ll.thespacedevs.com/2.2.0/program/11/?format=api", "name": "Commercial Resupply Services", "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "type": "Commercial" }, { "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/commercial2520_program_20201129212219.png", "start_date": "2008-12-23T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "v1.1", "alias": "", "min_stage": 2, "max_stage": 2, "length": 68.4, "diameter": 3.65, "maiden_flight": "2013-09-29", "launch_cost": "61200000", "launch_mass": 506, "leo_capacity": 13150, "gto_capacity": 4850, "to_thrust": 5883, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon252092520v1.1_image_20190222030927.jpeg", "info_url": "http://www.spacex.com/falcon9", "wiki_url": "https://en.wikipedia.org/wiki/Falcon_9_v1.1", "total_launch_count": 15, "consecutive_successful_launches": 1, "successful_launches": 14, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 5, "successful_landings": 0, "failed_landings": 6, "consecutive_successful_landings": 0 }, "launcher_stage": [ { "id": 67, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 26, "url": "https://ll.thespacedevs.com/2.2.0/launcher/26/?format=api", "details": "RUD at T + 139s - second stage overpressure event due to defective COPV strut heim joint", "flight_proven": true, "serial_number": "B1018", "status": "lost", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/26_image_20190226105108.jpeg", "successful_landings": 0, "attempted_landings": 1, "flights": 1, "last_launch_date": "2015-06-28T14:21:11Z", "first_launch_date": "2015-06-28T14:21:11Z" }, "landing": { "id": 57, "attempt": true, "success": false, "description": "", "downrange_distance": null, "location": { "id": 1, "name": "Of Course I Still Love You", "abbrev": "OCISLY", "description": "The second ASDS barge, Of Course I Still Love You (OCISLY) services launches in the Pacific Ocean and was the site of the first landing of a SpaceX Falcon 9 first stage during CRS-8, the launch of a Dragon spacecraft to the International Space Station.", "location": null, "successful_landings": 126 }, "type": { "id": 1, "name": "Autonomous Spaceport Drone Ship", "abbrev": "ASDS", "description": "An autonomous spaceport drone ship (ASDS) is an ocean-going vessel derived from a deck barge, outfitted with station-keeping engines and a large landing platform. Construction of such ships was commissioned by aerospace company SpaceX to allow for recovery of rocket first-stages at sea for high-velocity missions which do not carry enough fuel to return to the launch site after lofting spacecraft onto an orbital trajectory." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": { "id": 302, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/302/?format=api", "mission_end": "2015-06-28T14:23:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 218, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/218/?format=api", "name": "Dragon C109", "serial_number": "C109", "is_placeholder": false, "in_space": false, "time_in_space": "PT1M49S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 3, "name": "Destroyed" }, "description": "This vehicle was intended to deliver the first of two International Docking Adapters to modify the ISS adapters so that they could be used for future commercial crew missions. However the capsule was destroyed when the Falcon 9 launch vehicle failed in flight.", "spacecraft_config": { "id": 3, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/3/?format=api", "name": "Dragon 1", "type": { "id": 2, "name": "Capsule" }, "agency": { "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", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png" }, "in_use": false, "capability": "ISS Logistics", "history": "Dragon, also known as Dragon 1 or Cargo Dragon, was a class of fourteen partially reusable cargo spacecraft developed by SpaceX, an American private space transportation company.\r\n\r\nIt flew 23 missions between 2010 and 2020.\r\n\r\nDuring its maiden flight in December 2010, Dragon became the first commercially built and operated spacecraft to be recovered successfully from orbit.", "details": "The Dragon spacecraft consists of a nose-cone cap, a conventional blunt-cone ballistic capsule, and an unpressurized cargo-carrier trunk equipped with two solar arrays. Dragon was launched into orbit by the company's Falcon 9 launch vehicle to resupply the International Space Station (ISS).", "maiden_flight": "2010-12-08", "height": 6.1, "diameter": 3.7, "human_rated": false, "crew_capacity": null, "payload_capacity": 6000, "payload_return_capacity": 3000, "flight_life": "One week free flight, up to two years while berthed to the International Space Station.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/crs-172520dragon2520berthing_image_20190318203226.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Dragon_(spacecraft)", "info_link": "https://www.spacex.com/dragon" } }, "landing": { "id": 440, "attempt": false, "success": null, "description": "The Dragon spacecraft was destroyed during a launch failure.", "downrange_distance": null, "location": null, "type": null }, "docking_events": [] } }, "mission": { "id": 848, "name": "SpX CRS-7", "description": "A SpaceX Falcon 9 rocket launched the ninth Dragon spacecraft on the seventh operational cargo delivery mission to the International Space Station as part of the NASA cargo resupply contract. It was meant to deliver the IDA-1 segment of the new ISS International Docking System. \nThe second stage ruptured due to an overpressurization event and the launch vehicle disintegrated at T+139 seconds. According to SpaceX investigation, \"Preliminary analysis suggests the overpressure event in the upper stage liquid oxygen tank was initiated by a flawed piece of support hardware (a “strutâ€) inside the second stage.\"", "launch_designator": null, "type": "Resupply", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/pad/80/?format=api", "agency_id": 121, "name": "Space Launch Complex 40", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_40", "map_url": "https://www.google.com/maps?q=28.56194122,-80.57735736", "latitude": "28.56194122", "longitude": "-80.57735736", "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": 1015, "total_landing_count": 62 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_80_20200803143323.jpg", "total_launch_count": 300, "orbital_launch_attempt_count": 300 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "SpaceX CRS-7 Liftoff", "description": "The SpaceX CRS-7 Falcon 9 rocket lifts off from Space Launch Complex 40 at Cape Canaveral Air Force Station carrying a Dragon spacecraft on the seventh comme...", "feature_image": "https://i.ytimg.com/vi/efjf37ZPYz4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=efjf37ZPYz4", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "SpaceX CRS-7 Launch", "description": "After seven successful missions to the International Space Station, including six official resupply missions for NASA, SpaceX’s Falcon 9 rocket and Dragon sp...", "feature_image": "https://i.ytimg.com/vi/ZeiBFtkrZEw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=ZeiBFtkrZEw", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon252092520v1.1_image_20190222030927.jpeg", "infographic": null, "program": [ { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/program/11/?format=api", "name": "Commercial Resupply Services", "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "type": "Commercial" }, { "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/commercial2520_program_20201129212219.png", "start_date": "2008-12-23T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 5475, "location_launch_attempt_count": 729, "pad_launch_attempt_count": 73, "agency_launch_attempt_count": 24, "orbital_launch_attempt_count_year": 33, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 6, "pad_turnaround": "P61DT15H18M11S", "mission_patches": [ { "id": 553, "name": "SpX CRS-7 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/spx2520crs-72_mission_patch_20211031044153.png", "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } } ], "type": "detailed" }
