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/c019749b-6db8-406b-9704-098a246318dd/?format=api
{ "id": "c019749b-6db8-406b-9704-098a246318dd", "url": "https://ll.thespacedevs.com/2.2.0/launch/c019749b-6db8-406b-9704-098a246318dd/?format=api", "slug": "falcon-heavy-gateway-ppe-halo", "flightclub_url": null, "r_spacex_api_id": null, "name": "Falcon Heavy | Gateway PPE & HALO", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-08-02T06:50:06Z", "updates": [ { "id": 8200, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET 2027", "info_url": "https://www.gao.gov/products/gao-24-106878", "created_by": "Nosu", "created_on": "2024-08-02T06:50:07Z" }, { "id": 3534, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET 2025", "info_url": "https://www.nasa.gov/sites/default/files/atoms/files/fiscal_year_2024_nasa_budget_summary.pdf", "created_by": "Nosu", "created_on": "2023-03-13T16:09:34Z" }, { "id": 274, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding the launch", "info_url": "https://twitter.com/SpaceX/status/1359261256096509953", "created_by": "Nosu", "created_on": "2021-02-10T08:18:53Z" } ], "net": "2027-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00: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": 504, "consecutive_successful_launches": 27, "successful_launches": 490, "failed_launches": 14, "pending_launches": 118, "consecutive_successful_landings": 73, "successful_landings": 451, "failed_landings": 26, "attempted_landings": 476, "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": 2830, "configuration": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/161/?format=api", "name": "Falcon Heavy", "active": true, "reusable": true, "description": "The Falcon Heavy is a variant of the Falcon 9 full thrust launch vehicle and consists of a standard Falcon 9 rocket core, with two additional boosters derived from the Falcon 9 first stage.", "family": "Falcon", "full_name": "Falcon Heavy", "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": 504, "consecutive_successful_launches": 27, "successful_launches": 490, "failed_launches": 14, "pending_launches": 118, "consecutive_successful_landings": 73, "successful_landings": 451, "failed_landings": 26, "attempted_landings": 476, "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": [], "variant": "Heavy", "alias": "", "min_stage": 3, "max_stage": 3, "length": 70.0, "diameter": 12.2, "maiden_flight": "2018-02-06", "launch_cost": "90000000", "launch_mass": 1400, "leo_capacity": 63800, "gto_capacity": 26700, "to_thrust": 22819, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_image_20220129192819.jpeg", "info_url": "https://www.spacex.com/vehicles/falcon-heavy/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Falcon_Heavy", "total_launch_count": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 11, "attempted_landings": 21, "successful_landings": 19, "failed_landings": 2, "consecutive_successful_landings": 13 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1237, "name": "Gateway PPE & HALO", "description": "The Power and Propulsion Element (PPE) and Habitation and Logistics Outpost (HALO) are the foundational elements of NASA's lunar-orbiting space station \"Gateway\". The PPE is a 60-kilowatt class solar electric propulsion spacecraft that also will provide power, high-speed communications, attitude control and the capability to move the Gateway to different lunar orbits. The HALO is the pressurized living quarters where astronauts who visit the Gateway, often on their way to the Moon, will work. It will provide command and control and serve as the docking hub for the outpost. HALO will support science investigations, distribute power, provide communications for visiting vehicles and lunar surface expeditions, and supplement the life support systems aboard Orion, NASA’s spacecraft that will deliver Artemis astronauts to the Gateway.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 87, "url": "https://ll.thespacedevs.com/2.2.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kennedy_Space_Center_Launch_Complex_39#Launch_Pad_39A", "map_url": "https://www.google.com/maps?q=28.60822681,-80.60428186", "latitude": "28.60822681", "longitude": "-80.60428186", "location": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "description": "The John F. Kennedy Space Center, located on Merritt Island, Florida, is one of NASA's ten field centers. Since 1968, KSC has been NASA's primary launch center of American spaceflight, research, and technology. Launch operations for the Apollo, Skylab and Space Shuttle programs were carried out from Kennedy Space Center Launch Complex 39 and managed by KSC. Located on the east coast of Florida, KSC is adjacent to Cape Canaveral Space Force Station (CCSFS).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 264, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 206, "orbital_launch_attempt_count": 205 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_image_20220129192819.jpeg", "infographic": null, "program": [ { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/program/15/?format=api", "name": "Artemis", "description": "The Artemis program is a US government-funded crewed spaceflight program that has the goal of landing \"the first woman and the next man\" on the Moon, specifically at the lunar south pole region by 2024.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/artemis_program_20220827100930.png", "start_date": "2017-12-11T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/specials/artemis/", "wiki_url": "https://en.wikipedia.org/wiki/Artemis_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 7236, "location_launch_attempt_count": 276, "pad_launch_attempt_count": 215, "agency_launch_attempt_count": 613, "orbital_launch_attempt_count_year": 35, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 21, "pad_turnaround": "P365D", "mission_patches": [], "type": "detailed" }
