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/0b896593-2d29-4229-a381-568790d9cfce/?format=api
{ "id": "0b896593-2d29-4229-a381-568790d9cfce", "url": "https://ll.thespacedevs.com/2.3.0/launches/0b896593-2d29-4229-a381-568790d9cfce/?format=api", "name": "Scout B | San Marco 2", "response_mode": "detailed", "slug": "scout-b-san-marco-2", "launch_designator": "1967-038", "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:55Z", "net": "1967-04-26T10:06:24Z", "net_precision": null, "window_end": "1967-04-26T10:06:24Z", "window_start": "1967-04-26T10:06:24Z", "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": 3648, "configuration": { "response_mode": "detailed", "id": 358, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/358/?format=api", "name": "Scout B", "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 B", "variant": "B", "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": null, "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": "1965-08-10", "launch_cost": 8660000, "launch_mass": 17.0, "leo_capacity": 143.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 513.0, "apogee": null, "total_launch_count": 23, "consecutive_successful_launches": 15, "successful_launches": 21, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P13DT19H4M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 2066, "name": "San Marco 2", "type": "Earth Science", "description": "San Marco 2 was a 66-cm-diameter spherical satellite with two experiments, one designed to make direct measurements of air density below 350 km, and the other an ionospheric beacon experiment developed to observe electron content between the earth and the satellite.", "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": 155, "url": "https://ll.thespacedevs.com/2.3.0/pads/155/?format=api", "active": true, "agencies": [], "name": "San Marco platform", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Broglio_Space_Center", "map_url": "https://www.google.com/maps?q=-2.9383333,40.210306", "latitude": -2.9383333, "longitude": 40.210306, "country": { "id": 3, "name": "Italy", "alpha_2_code": "IT", "alpha_3_code": "ITA", "nationality_name": "Italian", "nationality_name_composed": "Italo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_155_20200803143349.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 9, "fastest_turnaround": "P132DT20H38M39S", "location": { "response_mode": "normal", "id": 151, "url": "https://ll.thespacedevs.com/2.3.0/locations/151/?format=api", "name": "Broglio Space Center, Kenya", "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": 7149, "successful_launches": 6606, "failed_launches": 543, "total_attempted_landings": 1103, "successful_landings": 1060, "failed_landings": 43 }, "active": false, "country": { "id": 3, "name": "Italy", "alpha_2_code": "IT", "alpha_3_code": "ITA", "nationality_name": "Italian", "nationality_name_composed": "Italo" }, "description": "The Luigi Broglio Space Center (BSC) located near Malindi, Kenya, is an Italian Space Agency (ASI) Spaceport. It served as a spaceport for the launch of both Italian and international satellites, but is currently only used for satellite communications.", "image": { "id": 2199, "name": "Scout-B1 on the San Marco platform (Ariel 5)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/scout-b1_on_the_image_20240918151220.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/scout-b1_on_the_image_thumbnail_20240918151221.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_151_20200803142409.jpg", "longitude": 40.2125, "latitude": -2.938333, "timezone_name": "Africa/Nairobi", "total_launch_count": 9, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 690, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 42, "location_launch_attempt_count_year": 1, "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": [] }
