Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/550f778d-6c2d-41fc-b182-6f0cd8feda93/?format=api
{ "id": "550f778d-6c2d-41fc-b182-6f0cd8feda93", "url": "https://ll.thespacedevs.com/2.0.0/launch/550f778d-6c2d-41fc-b182-6f0cd8feda93/?format=api", "launch_library_id": null, "slug": "vulcan-ussf-87", "name": "Vulcan | USSF-87", "status": { "id": 2, "name": "TBD" }, "net": "2025-12-31T00:00:00Z", "window_end": "2025-12-31T00:00:00Z", "window_start": "2025-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.0.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": 7859, "configuration": { "id": 200, "launch_library_id": 226, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/200/?format=api", "name": "Vulcan", "description": "Vulcan", "family": "Vulcan", "full_name": "Vulcan", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.0.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": "Vulcan", "alias": "", "min_stage": 2, "max_stage": 2, "length": null, "diameter": 5.4, "maiden_flight": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg", "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur", "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur#Certification_flights", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 26 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6367, "launch_library_id": null, "name": "USSF-87", "description": "USSF-87 will launch two identical Geosynchronous Space Situational Awareness Program (GSSAP) satellites GSSAP-7 and GSSAP-8 directly to a near-geosynchronous orbit approximately 36,000 km above the equator.\r\n\r\nData from the GSSAP will uniquely contribute to timely and accurate orbital predictions, further enabling space flight safety including satellite collision avoidance.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" } }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.0.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "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.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1020, "total_landing_count": 64 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 115 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7113, "location_launch_attempt_count": 1075, "pad_launch_attempt_count": 138, "agency_launch_attempt_count": 191, "orbital_launch_attempt_count_year": 264, "location_launch_attempt_count_year": 81, "pad_launch_attempt_count_year": 24, "agency_launch_attempt_count_year": 27 }
