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/b8ce3fba-ccd7-4492-9f0b-0edd7685e880/?format=api
{ "id": "b8ce3fba-ccd7-4492-9f0b-0edd7685e880", "url": "https://ll.thespacedevs.com/2.2.0/launch/b8ce3fba-ccd7-4492-9f0b-0edd7685e880/?format=api", "slug": "titan-ii-glv-gemini-xii", "flightclub_url": null, "r_spacex_api_id": null, "name": "Titan II GLV | Gemini XII", "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-11-11T13:10:38Z", "updates": [], "net": "1966-11-11T20:46:33Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "1966-11-11T20:46:33Z", "window_start": "1966-11-11T20:46:33Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 210, "configuration": { "id": 98, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/98/?format=api", "name": "Titan II", "active": false, "reusable": false, "description": "The Titan II GLV (Gemini Launch Vehicle) or Gemini-Titan II was an American expendable launch system derived from the Titan II missile, which was used to launch twelve Gemini missions for NASA between 1964 and 1966. Two unmanned launches followed by ten manned ones were conducted from Launch Complex 19 at the Cape Canaveral Air Force Station, starting with Gemini 1 on April 8, 1964.", "family": "Titan", "full_name": "Titan II GLV", "manufacturer": { "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "program": [ { "id": 3, "url": "https://ll.thespacedevs.com/2.2.0/program/3/?format=api", "name": "Gemini", "description": "Project Gemini was NASA's second human spaceflight program. Conducted between projects Mercury and Apollo, Gemini started in 1961 and concluded in 1966.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/project2520gem_program_20200820195350.png", "start_date": "1961-12-07T00:00:00Z", "end_date": "1966-11-15T19:21:04Z", "info_url": "https://www.nasa.gov/mission_pages/gemini/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Gemini", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "GLV", "alias": "", "min_stage": 2, "max_stage": 2, "length": 33.2, "diameter": 3.05, "maiden_flight": "1964-04-08", "launch_cost": null, "launch_mass": 154, "leo_capacity": 3850, "gto_capacity": null, "to_thrust": 1913, "apogee": null, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/titan2520ii_image_20190222030027.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Titan_II_GLV", "total_launch_count": 12, "consecutive_successful_launches": 12, "successful_launches": 12, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/20/?format=api", "mission_end": "1966-11-15T19:21:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 949, "role": { "id": 4, "role": "Command Pilot", "priority": 1 }, "astronaut": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/34/?format=api", "name": "Jim Lovell", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P29DT19H3M24S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1928-03-25", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "James Arthur Lovell Jr. is a former NASA astronaut, Naval Aviator, and retired Navy captain. Lovell is known for being the commander of the ill-fated Apollo 13 mission, which suffered a critical failure en route to the Moon but was brought back safely to Earth through the efforts of the crew and mission control. In addition to being part of the Apollo 13 crew, Lovell was the command module pilot of Apollo 8, the first Apollo mission to enter lunar orbit.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/jim2520lovell_image_20181128143638.jpg", "wiki": "https://en.wikipedia.org/wiki/Jim_Lovell", "last_flight": "1970-04-11T19:13:00Z", "first_flight": "1965-12-04T19:30:03Z" } }, { "id": 950, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/4/?format=api", "name": "Buzz Aldrin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P12DT1H52M27S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1930-01-20", "date_of_death": null, "nationality": "American", "twitter": "https://twitter.com/TheRealBuzz", "instagram": "https://www.instagram.com/drbuzzaldrin/", "bio": "Buzz Aldrin; born Edwin Eugene Aldrin Jr.; is an American engineer, former astronaut, and fighter pilot.\r\nAs Lunar Module Pilot on the Apollo 11 mission, he and mission commander Neil Armstrong were the first two humans to land on the Moon.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/buzz_aldrin_image_20220911034547.jpeg", "wiki": "https://en.wikipedia.org/wiki/Buzz_Aldrin", "last_flight": "1969-07-16T13:32:00Z", "first_flight": "1966-11-11T20:46:33Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 29, "role": { "id": 4, "role": "Command Pilot", "priority": 1 }, "astronaut": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/34/?format=api", "name": "Jim Lovell", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P29DT19H3M24S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1928-03-25", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "James Arthur Lovell Jr. is a former NASA astronaut, Naval Aviator, and retired Navy captain. Lovell is known for being the commander of the ill-fated Apollo 13 mission, which suffered a critical failure en route to the Moon but was brought back safely to Earth through the efforts of the crew and mission control. In addition to being part of the Apollo 13 crew, Lovell was the command module pilot of Apollo 8, the first Apollo mission to enter lunar orbit.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/jim2520lovell_image_20181128143638.jpg", "wiki": "https://en.wikipedia.org/wiki/Jim_Lovell", "last_flight": "1970-04-11T19:13:00Z", "first_flight": "1965-12-04T19:30:03Z" } }, { "id": 30, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/4/?format=api", "name": "Buzz Aldrin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P12DT1H52M27S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1930-01-20", "date_of_death": null, "nationality": "American", "twitter": "https://twitter.com/TheRealBuzz", "instagram": "https://www.instagram.com/drbuzzaldrin/", "bio": "Buzz Aldrin; born Edwin Eugene Aldrin Jr.; is an American engineer, former astronaut, and fighter pilot.\r\nAs Lunar Module Pilot on the Apollo 11 mission, he and mission commander Neil Armstrong were the first two humans to land on the Moon.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/buzz_aldrin_image_20220911034547.jpeg", "wiki": "https://en.wikipedia.org/wiki/Buzz_Aldrin", "last_flight": "1969-07-16T13:32:00Z", "first_flight": "1966-11-11T20:46:33Z" } } ], "spacecraft": { "id": 22, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/22/?format=api", "name": "Gemini SC12", "serial_number": "12", "is_placeholder": false, "in_space": false, "time_in_space": "P3DT22H34M27S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Gemini SC12 is the Gemini capsule used for the Gemini 12 mission launched on November 11, 1966 and crewed by astronauts James A. Lovell, Jr. (command pilot) and Edwin E. Aldrin, Jr. (pilot).", "spacecraft_config": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/12/?format=api", "name": "Gemini", "type": { "id": 2, "name": "Capsule" }, "agency": { "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "parent": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png" }, "in_use": false, "capability": "Human transportation to low Earth orbit.", "history": "The Gemini crew capsule (referred to as the Reentry Module) was essentially an enlarged version of the Mercury capsule. Unlike Mercury, the retrorockets, electrical power, propulsion systems, oxygen, and water were located in a detachable Adapter Module behind the Reentry Module. A major design improvement in Gemini was to locate all internal spacecraft systems in modular components, which could be independently tested and replaced when necessary, without removing or disturbing other already tested components.", "details": "The spacecraft was 18 feet 5 inches (5.61 m) long and 10 feet (3.0 m) wide, with a launch weight varying from 7,100 to 8,350 pounds (3,220 to 3,790 kg).", "maiden_flight": "1964-04-08", "height": 5.61, "diameter": 3.0, "human_rated": true, "crew_capacity": 2, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Between a few hours and multiple days (14 day is the maximum achieved).", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/gemini_image_20190207032517.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Project_Gemini#Spacecraft", "info_link": "" } }, "landing": { "id": 458, "attempt": true, "success": true, "description": "The Gemini spacecraft safely splashed down in the Atlantic Ocean.", "downrange_distance": null, "location": { "id": 6, "name": "Atlantic Ocean", "abbrev": "ATL", "description": "Atlantic Ocean", "location": null, "successful_landings": 0 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 258, "name": "Gemini XII (Gemini 12)", "description": "Gemini 12 was the tenth and final crewed mission of the NASA's Project Gemini. It was commanded by Command Pilot James A. Lovell, Jr. and Pilot Edwin \"Buzz\" Aldrin, Jr. The crew performed three EVAs, redezvoused and docked with an Agena target vehicle, and performed various scientific experiments. The mission started on November 11, 1966, 20:46:33 UTC and ended on November 15, 1966, 19:21:04 UTC.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/pad/18/?format=api", "agency_id": null, "name": "Launch Complex 19", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Launch_Complex_19", "map_url": "https://www.google.com/maps?q=28.506898,-80.554169", "latitude": "28.506898", "longitude": "-80.554169", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral, FL, USA", "country_code": "USA", "description": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 952, "total_landing_count": 51 }, "country_code": "USA", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_18_20200803143356.jpg", "total_launch_count": 12, "orbital_launch_attempt_count": 11 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": "www.youtube.com", "publisher": null, "title": "GEMINI XII - COLOUR - SOUND", "description": "(14 Nov 1966) Spacecraft arrival at Cape Kennedy and mated with Launch Vehicle. C.U. Astronaut LOVELL. C.U. Astronaut ALDRIN. Agena lift off. Gemini on pad. ...", "feature_image": "https://i.ytimg.com/vi/2KaQc2nTvYg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=2KaQc2nTvYg", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/titan2520ii_image_20190222030027.jpeg", "infographic": null, "program": [ { "id": 3, "url": "https://ll.thespacedevs.com/2.2.0/program/3/?format=api", "name": "Gemini", "description": "Project Gemini was NASA's second human spaceflight program. Conducted between projects Mercury and Apollo, Gemini started in 1961 and concluded in 1966.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/project2520gem_program_20200820195350.png", "start_date": "1961-12-07T00:00:00Z", "end_date": "1966-11-15T19:21:04Z", "info_url": "https://www.nasa.gov/mission_pages/gemini/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Gemini", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 630, "location_launch_attempt_count": 190, "pad_launch_attempt_count": 12, "agency_launch_attempt_count": 86, "orbital_launch_attempt_count_year": 114, "location_launch_attempt_count_year": 31, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 12, "pad_turnaround": "P60DT6H4M7S", "mission_patches": [ { "id": 122, "name": "Gemini XII (Gemini 12) Patch", "priority": 10, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/mission_patch_images/gemini2520xii_mission_patch_20211031042452.png", "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } } ], "type": "detailed" }
