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/3587bc21-73f7-4668-b388-5f0840c6064f/?format=api
{ "id": "3587bc21-73f7-4668-b388-5f0840c6064f", "url": "https://ll.thespacedevs.com/2.2.0/launch/3587bc21-73f7-4668-b388-5f0840c6064f/?format=api", "slug": "thor-able-ii-transit-1a", "flightclub_url": null, "r_spacex_api_id": null, "name": "Thor Able II | Transit 1A", "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:40:13Z", "updates": [], "net": "1959-09-17T14:34:00Z", "net_precision": null, "window_end": "1959-09-17T14:34:00Z", "window_start": "1959-09-17T14:34:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USAF", "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": "1947", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.af.mil", "wiki_url": "http://en.wikipedia.org/wiki/United_States_Air_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg" }, "rocket": { "id": 3050, "configuration": { "id": 389, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/389/?format=api", "name": "Thor Able II", "active": false, "reusable": false, "description": "American orbital launch vehicle. Thor with Able stage derived from Vanguard second stage.", "family": "Thor", "full_name": "Thor Able II", "manufacturer": { "id": 153, "url": "https://ll.thespacedevs.com/2.2.0/agencies/153/?format=api", "name": "McDonnell Douglas", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "MDC", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/McDonnell_Douglas", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "Able II", "alias": "", "min_stage": 2, "max_stage": 2, "length": 27.3, "diameter": 2.44, "maiden_flight": "1959-01-23", "launch_cost": null, "launch_mass": 52, "leo_capacity": null, "gto_capacity": null, "to_thrust": 668, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Thor-Able", "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1472, "name": "Transit 1A", "description": "The Transit satellite system was the first satellite navigation system to be used operationally. The system was used to provide accurate location for the US Navy ships. Transit 1A failed to make orbit.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 14, "url": "https://ll.thespacedevs.com/2.2.0/pad/14/?format=api", "agency_id": null, "name": "Space Launch Complex 17A", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Space_Launch_Complex_17", "map_url": "https://www.google.com/maps?q=28.4472,-80.565", "latitude": "28.4472", "longitude": "-80.565", "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": 1021, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_14_20200803143451.jpg", "total_launch_count": 145, "orbital_launch_attempt_count": 145 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 48, "location_launch_attempt_count": 27, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 17, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P41DT9M40S", "mission_patches": [], "type": "detailed" }
