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/c5ebc8b1-ae7f-4e8d-8619-99bbe0d8025a/?format=api
{ "id": "c5ebc8b1-ae7f-4e8d-8619-99bbe0d8025a", "url": "https://ll.thespacedevs.com/2.2.0/launch/c5ebc8b1-ae7f-4e8d-8619-99bbe0d8025a/?format=api", "slug": "new-glenn-blue-moon-pathfinder-mission-2-viper", "flightclub_url": null, "r_spacex_api_id": null, "name": "New Glenn | Blue Moon Pathfinder Mission 2 & VIPER", "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": "2025-09-20T00:21:08Z", "updates": [ { "id": 12315, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://www.nasa.gov/news-release/nasa-selects-blue-origin-to-deliver-viper-rover-to-moons-south-pole/", "created_by": "Cosmic_Penguin", "created_on": "2025-09-20T00:21:00Z" } ], "net": "2027-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 37, "consecutive_successful_launches": 14, "successful_launches": 36, "failed_launches": 1, "pending_launches": 6, "consecutive_successful_landings": 8, "successful_landings": 34, "failed_landings": 3, "attempted_landings": 37, "info_url": "https://www.blueorigin.com/", "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" }, "rocket": { "id": 8723, "configuration": { "id": 138, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/138/?format=api", "name": "New Glenn", "active": false, "reusable": true, "description": "The New Glenn is a privately funded orbital launch vehicle in development by Blue Origin. New Glenn is described as a 7-meter-diameter (23 ft), two- or three-stage rocket.", "family": "", "full_name": "New Glenn", "manufacturer": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 37, "consecutive_successful_launches": 14, "successful_launches": 36, "failed_launches": 1, "pending_launches": 6, "consecutive_successful_landings": 8, "successful_landings": 34, "failed_landings": 3, "attempted_landings": 37, "info_url": "https://www.blueorigin.com/", "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 82.0, "diameter": 7.0, "maiden_flight": "2025-01-16", "launch_cost": null, "launch_mass": null, "leo_capacity": 45000, "gto_capacity": 13000, "to_thrust": 17100, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg", "info_url": "https://www.blueorigin.com/new-glenn/", "wiki_url": "https://en.wikipedia.org/wiki/New_Glenn", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 5, "attempted_landings": 1, "successful_landings": 0, "failed_landings": 1, "consecutive_successful_landings": 0 }, "launcher_stage": [ { "id": 814, "type": "Core", "reused": null, "launcher_flight_number": null, "launcher": { "id": 152, "url": "https://ll.thespacedevs.com/2.2.0/launcher/152/?format=api", "details": "Booster serial number unknown.", "flight_proven": false, "serial_number": "Unknown NG", "status": "N/A", "image_url": null, "successful_landings": null, "attempted_landings": null, "flights": null, "last_launch_date": null, "first_launch_date": null }, "landing": null, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 7314, "name": "Blue Moon Pathfinder Mission 2 & VIPER", "description": "2nd of the National Team’s Blue Moon MK1 lunar lander test missions to validate the necessary technologies for its HLS lunar module. Some of the life support hardware will travel on this mission in preparation for the first crew Blue Moon flight.\r\n\r\nThis mission will also carry NASA’s VIPER (Volatiles Investigating Polar Exploration Rover) lunar rover. VIPER is designed to explore the relatively nearby but extreme environment of the Moon in search of ice and other potential resources. This mobile robot will land at the South Pole of the Moon on a 100-day mission, in order to teach us about the origin and distribution of water on the Moon and help determine how we can harvest the Moon's resources for future human space exploration.\r\n\r\nVIPER is designed to roam the Moon using its three instruments and a 1 meter long drill to detect and analyze various lunar soil environments at a range of depths and temperatures. The rover can venture into permanently shadowed craters, some of the coldest spots in the solar system, where ice reserves have endured for billions of years.\r\n\r\nThe rover was originally slated to launch on Astrobotic’s Griffin Mission One lunar lander (with the Falcon Heavy rocket), but the VIPER mission was cancelled in July 2024 due to budget cuts. After consulting with the industry to find alternative ways to deliver the rover to the lunar surface, NASA ultimately chose to launch it with Blue Origin’s 2nd Blue Moon MK1 lander mission.", "launch_designator": null, "type": "Robotic Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "BO", "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.", "administrator": "CEO: Jeff Bezos", "founding_year": "2000", "launchers": "New Shepard | New Glenn", "spacecraft": "", "launch_library_url": null, "total_launch_count": 37, "consecutive_successful_launches": 14, "successful_launches": 36, "failed_launches": 1, "pending_launches": 6, "consecutive_successful_landings": 8, "successful_landings": 34, "failed_landings": 3, "attempted_landings": 37, "info_url": "https://www.blueorigin.com/", "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 5, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.nasa.gov", "wiki_url": "https://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" } ], "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": 1058, "total_landing_count": 68 }, "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": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7371, "location_launch_attempt_count": 1159, "pad_launch_attempt_count": 74, "agency_launch_attempt_count": 43, "orbital_launch_attempt_count_year": 58, "location_launch_attempt_count_year": 26, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P365D", "mission_patches": [], "type": "detailed" }
