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/fe0e3b37-d0b6-4ac0-aec7-bbcf7c25ab51/?format=api
{ "id": "fe0e3b37-d0b6-4ac0-aec7-bbcf7c25ab51", "url": "https://ll.thespacedevs.com/2.3.0/launches/fe0e3b37-d0b6-4ac0-aec7-bbcf7c25ab51/?format=api", "name": "Scout D-1 | ESRO 4", "response_mode": "detailed", "slug": "scout-d-1-esro-4", "launch_designator": "1972-092", "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-06-14T04:25:51Z", "net": "1972-11-22T00:17:01Z", "net_precision": null, "window_end": "1972-11-22T00:17:01Z", "window_start": "1972-11-22T00:17:01Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1019, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1019/?format=api", "name": "European Space Research Organisation", "abbrev": "ESRO", "type": { "id": 2, "name": "Multinational" }, "featured": false, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" }, { "id": 3, "name": "Italy", "alpha_2_code": "IT", "alpha_3_code": "ITA", "nationality_name": "Italian", "nationality_name_composed": "Italo" }, { "id": 4, "name": "Germany", "alpha_2_code": "DE", "alpha_3_code": "DEU", "nationality_name": "German", "nationality_name_composed": "Germano" }, { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" }, { "id": 8, "name": "Switzerland", "alpha_2_code": "CH", "alpha_3_code": "CHE", "nationality_name": "Swiss", "nationality_name_composed": "Swiss" }, { "id": 10, "name": "United Kingdom", "alpha_2_code": "GB", "alpha_3_code": "GBR", "nationality_name": "British", "nationality_name_composed": "Brito" }, { "id": 15, "name": "Sweden", "alpha_2_code": "SE", "alpha_3_code": "SWE", "nationality_name": "Swedish", "nationality_name_composed": "Swedo" }, { "id": 20, "name": "Belgium", "alpha_2_code": "BE", "alpha_3_code": "BEL", "nationality_name": "Belgian", "nationality_name_composed": "Belgo" }, { "id": 27, "name": "Netherlands", "alpha_2_code": "NL", "alpha_3_code": "NLD", "nationality_name": "Dutch", "nationality_name_composed": "Dutch" }, { "id": 45, "name": "Denmark", "alpha_2_code": "DK", "alpha_3_code": "DNK", "nationality_name": "Danish", "nationality_name_composed": "Dano" } ], "description": "The European Space Research Organisation (ESRO) was an international organisation founded by 10 European nations with the intention of jointly pursuing scientific research in space. It was founded in 1964. As an organisation ESRO was based on a previously existing international scientific institution, CERN. The ESRO convention, the organisations founding document outlines it as an entity exclusively devoted to scientific pursuits. This was the case for most of its lifetime but in the final years before the formation of ESA, the European Space Agency, ESRO began a programme in the field of telecommunications.", "administrator": null, "founding_year": 1964, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 5, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 1, "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/European_Space_Research_Organisation", "social_media_links": [] }, "rocket": { "id": 4315, "configuration": { "response_mode": "detailed", "id": 360, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/360/?format=api", "name": "Scout D-1", "families": [ { "response_mode": "detailed", "id": 139, "name": "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-10-04", "total_launch_count": 109, "consecutive_successful_launches": 25, "successful_launches": 97, "failed_launches": 12, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Scout D-1", "variant": "D-1", "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": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Scout_(rocket_family)", "description": "The Scout family of rockets were were American launch vehicles designed to place small satellites into orbit around the Earth. The Scout multistage rocket was the first orbital launch vehicle to be entirely composed of solid fuel stages.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 25.0, "diameter": 1.14, "maiden_flight": "1972-08-13", "launch_cost": null, "launch_mass": 20.0, "leo_capacity": 183.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 464.0, "apogee": null, "total_launch_count": 16, "consecutive_successful_launches": 16, "successful_launches": 16, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P6DT2H3M15S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 2733, "name": "ESRO 4", "type": "Earth Science", "description": "European ionospheric and magnetospheric research satellite", "image": null, "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 154, "url": "https://ll.thespacedevs.com/2.3.0/pads/154/?format=api", "active": false, "agencies": [], "name": "Space Launch Complex 5", "image": { "id": 1984, "name": "Scout X-4 S122 rocket launch from Vandenberg Launch Complex 5", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/scout_x-4_s122__image_20240311075016.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/scout_x-4_s122__image_thumbnail_20240311075016.jpeg", "credit": "U.S. Air Force", "license": { "id": 17, "name": "Department of Defense Image Use Policy", "priority": 6, "link": "https://www.dimoc.mil/resources/limitations/" }, "single_use": true, "variants": [] }, "description": "Space Launch Complex 5 (SLC-5) was a launch pad at Vandenberg Space Force Base in California, United States. It was previously part of the Point Arguello Naval Air Station, during which time it was designated Launch Complex D or LC-D. Constructed in 1961, it was used by 69 Scout launch vehicles between 1962 and 1994.", "info_url": "http://www.astronautix.com/v/vandenbergslc5.html", "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Air_Force_Base_Space_Launch_Complex_5", "map_url": "https://www.google.com/maps?q=34.6080,-120.6247", "latitude": 34.608, "longitude": -120.6247, "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_154_20200803143408.jpg", "total_launch_count": 69, "orbital_launch_attempt_count": 69, "fastest_turnaround": "P11DT17H59S", "location": { "response_mode": "normal", "id": 11, "url": "https://ll.thespacedevs.com/2.3.0/locations/11/?format=api", "name": "Vandenberg SFB, CA, 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": 7144, "successful_launches": 6601, "failed_launches": 543, "total_attempted_landings": 1100, "successful_landings": 1057, "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": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "image": { "id": 2226, "name": "Vandenberg SFB imaged by Sentinel-2", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_20240920082910.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vandenberg_sfb__image_thumbnail_20240920082910.jpeg", "credit": "Contains modified Copernicus Sentinel data 2020", "license": { "id": 33, "name": "Copernicus Image Use Policy", "priority": 0, "link": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32013R1159" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "longitude": -120.52023, "latitude": 34.75133, "timezone_name": "America/Los_Angeles", "total_launch_count": 804, "total_landing_count": 26 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 1406, "location_launch_attempt_count": 393, "pad_launch_attempt_count": 41, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 100, "location_launch_attempt_count_year": 18, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P80DT6H26M31S", "mission_patches": [] }
