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/3c4f8b1a-e747-4a26-9fd2-77c4bbb7034e/?format=api
{ "id": "3c4f8b1a-e747-4a26-9fd2-77c4bbb7034e", "url": "https://ll.thespacedevs.com/2.3.0/launches/3c4f8b1a-e747-4a26-9fd2-77c4bbb7034e/?format=api", "name": "Scout X-4 | San Marco 1", "response_mode": "detailed", "slug": "scout-x-4-san-marco-1", "launch_designator": "1964-084", "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:29:55Z", "net": "1964-12-15T20:20:04Z", "net_precision": null, "window_end": "1964-12-15T20:20:04Z", "window_start": "1964-12-15T20:20:04Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1018, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1018/?format=api", "name": "National Research Council", "abbrev": "CNR", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 3, "name": "Italy", "alpha_2_code": "IT", "alpha_3_code": "ITA", "nationality_name": "Italian", "nationality_name_composed": "Italo" } ], "description": "The Consiglio Nazionale delle Ricerche (CNR) or National Research Council, is the largest research council in Italy. As a public organisation, its remit is to support scientific and technological research. Its headquarters are in Rome.", "administrator": "President: Maria Chiara Carrozza", "founding_year": 1923, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 163, "name": "[AUTO] National Research Council - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520research2520council_logo_20231225172013.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185047.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 78, "name": "[AUTO] National Research Council - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520research2520council_nation_20231225172015.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184826.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "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": "https://www.cnr.it/", "wiki_url": "https://en.wikipedia.org/wiki/National_Research_Council_(Italy)", "social_media_links": [] }, "rocket": { "id": 3347, "configuration": { "response_mode": "detailed", "id": 370, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/370/?format=api", "name": "Scout X-4", "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 X-4", "variant": "4", "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.01, "maiden_flight": "1963-06-28", "launch_cost": null, "launch_mass": 17.0, "leo_capacity": 103.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 513.0, "apogee": null, "total_launch_count": 12, "consecutive_successful_launches": 8, "successful_launches": 11, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P15DT5H7M38S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1768, "name": "San Marco 1", "type": "Test Flight", "description": "San Marco 1 was an Italian flight test of the satellite to furnish data on air density and ionosphere characteristics. The Scout-X4 launch vehicle was provided by NASA and was launched with an Italian launch crew from Wallops Island.", "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": 178, "url": "https://ll.thespacedevs.com/2.3.0/pads/178/?format=api", "active": true, "agencies": [], "name": "Launch Area 3A", "image": null, "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=37.8495,-75.4725", "latitude": 37.8495, "longitude": -75.4725, "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_178_20200803143407.jpg", "total_launch_count": 18, "orbital_launch_attempt_count": 13, "fastest_turnaround": "P35DT4H52M", "location": { "response_mode": "normal", "id": 21, "url": "https://ll.thespacedevs.com/2.3.0/locations/21/?format=api", "name": "Wallops Flight Facility, Virginia, 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": 7153, "successful_launches": 6610, "failed_launches": 543, "total_attempted_landings": 1106, "successful_landings": 1063, "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": "Wallops Flight Facility is a rocket launch site on Wallops Island on the Eastern Shore of Virginia, United States, just east of the Delmarva Peninsula and north-northeast of Norfolk. The facility is operated by the Goddard Space Flight Center in Greenbelt, Maryland, and primarily serves to support science and exploration missions for NASA and other federal agencies. WFF includes an extensively instrumented range to support launches of more than a dozen types of sounding rockets; small expendable suborbital and orbital rockets; high-altitude balloon flights carrying scientific instruments for atmospheric and astronomical research; and, using its Research Airport, flight tests of aeronautical research aircraft, including uncrewed aerial vehicles.", "image": { "id": 2227, "name": "Wallops Flight Facility", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/wallops_flight__image_20240920083715.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/wallops_flight__image_thumbnail_20240920083715.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_21_20200803142423.jpg", "longitude": -75.467778, "latitude": 37.933333, "timezone_name": "America/New_York", "total_launch_count": 80, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 390, "location_launch_attempt_count": 26, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 97, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
