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/f01164c8-7579-4cfd-a804-bf5a50e11b93/?format=api
{ "id": "f01164c8-7579-4cfd-a804-bf5a50e11b93", "url": "https://ll.thespacedevs.com/2.2.0/launch/f01164c8-7579-4cfd-a804-bf5a50e11b93/?format=api", "slug": "atlas-iias-nrol-18", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas IIAS | NROL-18", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T03:42:25Z", "updates": [], "net": "2003-12-02T10:04:00Z", "net_precision": null, "window_end": "2003-12-02T10:04:00Z", "window_start": "2003-12-02T10:04:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 82, "url": "https://ll.thespacedevs.com/2.2.0/agencies/82/?format=api", "name": "Lockheed Martin", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "LMT", "description": "Lockheed Martin's Space Division started in the production of missiles and later ICBM's in the 1950s. Their TITAN missile system was used for 12 Gemini spacecraft and the Voyager probes. They have worked largely in collaboration with NASA on many of their probes, landers, and spacecraft, and hope to play a key role in NASA's return to the moon in 2024.", "administrator": null, "founding_year": "1953", "launchers": "Titan | Agena", "spacecraft": "Hubble | JUNO | InSight", "launch_library_url": null, "total_launch_count": 80, "consecutive_successful_launches": 38, "successful_launches": 77, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.lockheedmartin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Lockheed_Martin", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 7160, "configuration": { "id": 255, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/255/?format=api", "name": "Atlas IIAS", "active": false, "reusable": false, "description": "Atlas II was a member of the Atlas family of launch vehicles, which evolved from the successful Atlas missile program of the 1950s. It was designed to launch payloads into low earth orbit, geosynchronous transfer orbit or geosynchronous orbit. Sixty-three launches of the Atlas II, IIA and IIAS models were carried out between 1991 and 2004; all sixty-three launches were successes, making the Atlas II the most reliable launch system in history.", "family": "Atlas", "full_name": "Atlas IIAS", "manufacturer": { "id": 82, "url": "https://ll.thespacedevs.com/2.2.0/agencies/82/?format=api", "name": "Lockheed Martin", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "LMT", "description": "Lockheed Martin's Space Division started in the production of missiles and later ICBM's in the 1950s. Their TITAN missile system was used for 12 Gemini spacecraft and the Voyager probes. They have worked largely in collaboration with NASA on many of their probes, landers, and spacecraft, and hope to play a key role in NASA's return to the moon in 2024.", "administrator": null, "founding_year": "1953", "launchers": "Titan | Agena", "spacecraft": "Hubble | JUNO | InSight", "launch_library_url": null, "total_launch_count": 80, "consecutive_successful_launches": 38, "successful_launches": 77, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.lockheedmartin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Lockheed_Martin", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "IIAS", "alias": "", "min_stage": 3, "max_stage": 3, "length": 47.54, "diameter": 3.04, "maiden_flight": "1993-12-16", "launch_cost": null, "launch_mass": 204, "leo_capacity": 6580, "gto_capacity": 2810, "to_thrust": 4391, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Atlas_II", "total_launch_count": 30, "consecutive_successful_launches": 30, "successful_launches": 30, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 5549, "name": "NROL-18 (Intruder 6A & 6B)", "description": "USA 173 is an American military satellite (operated by the National Reconnaissance Office)", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/pad/24/?format=api", "agency_id": 161, "name": "Space Launch Complex 3E", "description": "SLC-3E is a launch pad at Vandenberg Space Force Base. It was originally built for the MIDAS program and later used for various other missions. After a period of inactivity, it was refurbished in the early 2000s to launch Atlas V rockets. The pad is now being upgraded to accommodate the new Vulcan Centaur rocket. The last Atlas V launch from SLC-3E happened in November 2022, with the first Vulcan launch expected in 2025.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_3#SLC-3E", "map_url": "https://www.google.com/maps?q=34.64,-120.5895", "latitude": "34.64", "longitude": "-120.5895", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 807, "total_landing_count": 26 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_24_20200803143552.jpg", "total_launch_count": 48, "orbital_launch_attempt_count": 45 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 4632, "location_launch_attempt_count": 616, "pad_launch_attempt_count": 31, "agency_launch_attempt_count": 69, "orbital_launch_attempt_count_year": 56, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P814DT18H38M55S", "mission_patches": [ { "id": 479, "name": "NROL-18 (Intruder 6A & 6B) Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-18252025_mission_patch_20211031044057.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
