Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/launches/5b288b8a-3861-4114-828f-8b1a363c6b73/?format=api
{ "id": "5b288b8a-3861-4114-828f-8b1a363c6b73", "url": "https://ll.thespacedevs.com/2.3.0/launches/5b288b8a-3861-4114-828f-8b1a363c6b73/?format=api", "name": "Blue Scout II | Mercury-Scout 1", "response_mode": "detailed", "slug": "blue-scout-ii-mercury-scout-1", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T17:39:58Z", "net": "1961-11-01T15:32:00Z", "net_precision": null, "window_end": "1961-11-01T15:32:00Z", "window_start": "1961-11-01T15:32:00Z", "image": { "id": 2055, "name": "Blue Scout II", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue_scout_ii_image_20240411085341.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue_scout_ii_image_thumbnail_20240411085341.png", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 44, "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "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", "parent": null, "image": { "id": 19, "name": "[AUTO] National Aeronautics and Space Administration - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184631.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 161, "name": "[AUTO] National Aeronautics and Space Administration - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185043.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 76, "name": "[AUTO] National Aeronautics and Space Administration - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184823.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 178, "failed_landings_spacecraft": 2, "attempted_landings_spacecraft": 180, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "social_media_links": [] }, "rocket": { "id": 7443, "configuration": { "response_mode": "detailed", "id": 264, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/264/?format=api", "name": "Blue Scout II", "families": [ { "response_mode": "detailed", "id": 68, "name": "Blue Scout", "manufacturer": [ { "response_mode": "normal", "id": 1006, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1006/?format=api", "name": "Vought", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Vought was the name of several related American aerospace firms. These have included, in the past, Lewis and Vought Corporation, Chance Vought, Vought-Sikorsky, LTV Aerospace (part of Ling-Temco-Vought), Vought Aircraft Companies, and Vought Aircraft Industries. The first incarnation of Vought was established by Chance M. Vought and Birdseye Lewis in 1917. In 1928, it was acquired by United Aircraft and Transport Corporation, which a few years later became United Aircraft Corporation; this was the first of many reorganizations and buyouts. During the 1920s and 1930s, Vought Aircraft and Chance Vought specialized in carrier-based aircraft for the United States Navy, by far its biggest customer. Chance Vought produced thousands of planes during World War II, including the F4U Corsair. Vought became independent again in 1954, and was purchased by Ling-Temco-Vought in 1961. The company designed and produced a variety of planes and missiles throughout the Cold War. Vought was sold from LTV and owned in various degrees by the Carlyle Group and Northrop Grumman in the early 1990s. It was then fully bought by Carlyle, renamed Vought Aircraft Industries, with headquarters in Dallas, Texas. In June 2010, the Carlyle Group sold Vought to the Triumph Group.", "administrator": null, "founding_year": 1917, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": 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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vought", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1960-09-21", "total_launch_count": 9, "consecutive_successful_launches": 6, "successful_launches": 8, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Blue Scout II", "variant": "II", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1006, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1006/?format=api", "name": "Vought", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Vought was the name of several related American aerospace firms. These have included, in the past, Lewis and Vought Corporation, Chance Vought, Vought-Sikorsky, LTV Aerospace (part of Ling-Temco-Vought), Vought Aircraft Companies, and Vought Aircraft Industries. The first incarnation of Vought was established by Chance M. Vought and Birdseye Lewis in 1917. In 1928, it was acquired by United Aircraft and Transport Corporation, which a few years later became United Aircraft Corporation; this was the first of many reorganizations and buyouts. During the 1920s and 1930s, Vought Aircraft and Chance Vought specialized in carrier-based aircraft for the United States Navy, by far its biggest customer. Chance Vought produced thousands of planes during World War II, including the F4U Corsair. Vought became independent again in 1954, and was purchased by Ling-Temco-Vought in 1961. The company designed and produced a variety of planes and missiles throughout the Cold War. Vought was sold from LTV and owned in various degrees by the Carlyle Group and Northrop Grumman in the early 1990s. It was then fully bought by Carlyle, renamed Vought Aircraft Industries, with headquarters in Dallas, Texas. In June 2010, the Carlyle Group sold Vought to the Triumph Group.", "administrator": null, "founding_year": 1917, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": 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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vought", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 2055, "name": "Blue Scout II", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue_scout_ii_image_20240411085341.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue_scout_ii_image_thumbnail_20240411085341.png", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/RM-90_Blue_Scout_II", "description": "The RM-90 Blue Scout II was an American sounding rocket and expendable launch system which was flown three times during 1961. It was used for two HETS test flights, and the launch of the Mercury-Scout 1 satellite for NASA. It was a member of the Scout family of rockets.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 24.0, "diameter": 1.02, "maiden_flight": "1961-03-03", "launch_cost": null, "launch_mass": 16.0, "leo_capacity": 30.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 471.0, "apogee": null, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5834, "name": "Mercury-Scout 1", "type": "Communications", "description": "Mercury-Scout 1, or MS-1, was a United States spacecraft intended to test tracking stations for Project Mercury flights. The launch of Mercury-Scout 1 on November 1, 1961 was unsuccessful, and the satellite failed to achieve orbit.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 119, "url": "https://ll.thespacedevs.com/2.3.0/pads/119/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 161, "url": "https://ll.thespacedevs.com/2.3.0/agencies/161/?format=api", "name": "United States Air Force", "abbrev": "USAF", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": 1947, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 193, "name": "[AUTO] United States Air Force - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185152.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 99, "name": "[AUTO] United States Air Force - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184855.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Launch Complex 18B", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_18", "map_url": "https://www.google.com/maps?q=28.4493,-80.564494", "latitude": 28.4493, "longitude": -80.564494, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_119_20200803143226.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7147, "successful_launches": 6604, "failed_launches": 543, "total_attempted_landings": 1101, "successful_landings": 1058, "failed_landings": 43 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "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.", "image": { "id": 2200, "name": "Cape Canaveral & KSC seen from orbit (STS-43)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "longitude": -80.577778, "latitude": 28.488889, "timezone_name": "America/New_York", "total_launch_count": 1019, "total_landing_count": 64 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 2, "url": "https://ll.thespacedevs.com/2.3.0/programs/2/?format=api", "name": "Mercury", "image": { "id": 1880, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/project2520mer_program_20200820194755.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194025.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "agencies": [ { "response_mode": "list", "id": 44, "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" } } ], "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 132, "location_launch_attempt_count": 69, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 35, "orbital_launch_attempt_count_year": 39, "location_launch_attempt_count_year": 19, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 16, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
