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/0c5642f3-24ae-4879-a8e9-981ad36a8911/?format=api
{ "id": "0c5642f3-24ae-4879-a8e9-981ad36a8911", "url": "https://ll.thespacedevs.com/2.2.0/launch/0c5642f3-24ae-4879-a8e9-981ad36a8911/?format=api", "slug": "vulcan-vc4s-ussf-106", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vulcan VC4S | USSF-106", "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-12-19T02:57:50Z", "updates": [ { "id": 9579, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q2 2025.", "info_url": "https://spaceflightnow.com/2024/12/18/space-force-says-first-national-security-vulcan-launch-now-anticipated-in-spring-2025/", "created_by": "Cosmic_Penguin", "created_on": "2024-12-19T02:57:00Z" }, { "id": 9277, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET early 2025.", "info_url": "https://breakingdefense.com/2024/11/ulas-vulcan-may-forfeit-planned-space-force-launches-this-year/", "created_by": "Cosmic_Penguin", "created_on": "2024-11-22T10:17:00Z" }, { "id": 8952, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q4 2024.", "info_url": "https://x.com/ulalaunch/status/1848428959349760147", "created_by": "Cosmic_Penguin", "created_on": "2024-10-21T18:28:00Z" }, { "id": 8750, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2024.", "info_url": "https://x.com/dpoddolphinpro/status/1841558631344709658", "created_by": "Cosmic_Penguin", "created_on": "2024-10-03T01:25:00Z" }, { "id": 8227, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Reportedly targeting October", "info_url": "https://x.com/StephenClark1/status/1820181812976427505", "created_by": "Nosu", "created_on": "2024-08-04T20:17:05Z" }, { "id": 7528, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2024.", "info_url": "https://spacenews.com/pentagon-urges-ula-to-fly-dummy-payload-on-next-vulcan-launch-if-dream-chaser-is-delayed/", "created_by": "Cosmic_Penguin", "created_on": "2024-05-14T10:01:50Z" }, { "id": 7188, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET summer 2024, pending Vulcan Cert-2 status.", "info_url": "https://spaceflightnow.com/2024/02/12/cleanest-first-flight-ula-president-reflects-on-inaugural-vulcan-launch-and-future-of-program/", "created_by": "Cosmic_Penguin", "created_on": "2024-04-02T13:28:17Z" }, { "id": 2572, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Mid to late 2023", "info_url": "https://spacenews.com/new-head-of-afrl-space-vehicles-looking-for-talent-to-help-push-technology-forward/", "created_by": "Nosu", "created_on": "2022-10-11T07:13:45Z" }, { "id": 803, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/scorp_profile_20210217185945.jpg", "comment": "Pushing to Q2 FY23", "info_url": "https://twitter.com/TGMetsFan98/status/1435326420910215174", "created_by": "JRascagneres", "created_on": "2021-09-07T19:56:38Z" } ], "net": "2025-06-30T00:00:00Z", "net_precision": { "id": 9, "name": "Quarter 2", "abbrev": "Q2", "description": "The T-0 is expected in the second quarter of the given year." }, "window_end": "2025-06-30T00:00:00Z", "window_start": "2025-06-30T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 2743, "configuration": { "id": 516, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/516/?format=api", "name": "Vulcan VC4S", "active": true, "reusable": false, "description": "Vulcan Centaur is a two-stage-to-orbit, heavy-lift launch vehicle under development by United Launch Alliance (ULA) since 2014. It is principally designed to meet launch demands for the U.S. government's National Security Space Launch (NSSL) program for use by the United States Space Force and U.S. intelligence agencies for national security satellite launches. It will replace both of ULA's existing launchers (Atlas V and Delta IV Heavy) in this role, as these launchers are retiring.", "family": "Vulcan", "full_name": "Vulcan VC4S", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "VC4S", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur", "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1141, "name": "USSF-106", "description": "USSF-106 is a mission for the United States Space Force. The launch will deploy various payloads directly into geosynchronous orbit, including the NTS-3 (Navigation Technology Satellite 3), a demonstration navigation satellite testing a new digital signal generator that can be reprogrammed on-orbit to broadcast new signals, improve performance by avoiding and defeating interference, and adding signatures for detecting spoofing attacks.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 3, "name": "Geosynchronous Orbit", "abbrev": "GSO" }, "agencies": [ { "id": 1041, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api", "name": "United States Space Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USSF", "description": "The United States Space Force (USSF) is the space service branch of the U.S. Armed Forces, one of the eight U.S. uniformed services.", "administrator": null, "founding_year": "2019", "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": "https://www.spaceforce.mil/", "wiki_url": "https://en.wikipedia.org/wiki/United_States_Space_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520space2520force_logo_20221102113048.png", "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "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_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 6975, "location_launch_attempt_count": 1030, "pad_launch_attempt_count": 116, "agency_launch_attempt_count": 166, "orbital_launch_attempt_count_year": 126, "location_launch_attempt_count_year": 36, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P62DT59M", "mission_patches": [ { "id": 743, "name": "US Space Force Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/us2520space25_mission_patch_20221102113104.png", "agency": { "id": 1041, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api", "name": "United States Space Force", "type": "Government" } } ], "type": "detailed" }
