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/903f0d20-2fc0-4187-8fd3-336888ae1c04/?format=api
{ "id": "903f0d20-2fc0-4187-8fd3-336888ae1c04", "url": "https://ll.thespacedevs.com/2.2.0/launch/903f0d20-2fc0-4187-8fd3-336888ae1c04/?format=api", "slug": "atlas-slv-3d-centaur-comstar-1d", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas SLV-3D Centaur | Comstar 1D", "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-14T17:40:04Z", "updates": [], "net": "1981-02-21T23:23:00Z", "net_precision": null, "window_end": "1981-02-21T23:23:00Z", "window_start": "1981-02-21T23:23:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 1004, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1004/?format=api", "name": "Convair", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": "1943", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Convair", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 5252, "configuration": { "id": 261, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/261/?format=api", "name": "Atlas SLV-3D Centaur", "active": false, "reusable": false, "description": "The Atlas-Centaur was a US expendable launch vehicle derived from the SM-65 Atlas D missile. Launches were conducted from Launch Complex 36 at the Cape Canaveral Air Force Station in Florida.", "family": "Atlas", "full_name": "Atlas SLV-3D Centaur", "manufacturer": { "id": 1004, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1004/?format=api", "name": "Convair", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": "1943", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Convair", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "SLV-3D Centaur", "alias": "", "min_stage": 2, "max_stage": 2, "length": 21.0, "diameter": 3.05, "maiden_flight": "1973-04-06", "launch_cost": null, "launch_mass": 120, "leo_capacity": 800, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Atlas-Centaurr", "total_launch_count": 32, "consecutive_successful_launches": 19, "successful_launches": 30, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 3661, "name": "Comstar 1D", "description": "Geostationary communications satellite built by Hughes Aircraft Company", "launch_designator": null, "type": "Communications", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/pad/121/?format=api", "agency_id": 161, "name": "Launch Complex 36A", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_36", "map_url": "https://www.google.com/maps?q=28.4705556,-80.542194", "latitude": "28.4705556", "longitude": "-80.542194", "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": 1023, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_121_20200803143231.jpg", "total_launch_count": 69, "orbital_launch_attempt_count": 69 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 2410, "location_launch_attempt_count": 370, "pad_launch_attempt_count": 28, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 19, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P113DT19H29M", "mission_patches": [], "type": "detailed" }
