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/22e0b528-dff5-4cc8-a4ed-6111096a5859/?format=api
{ "id": "22e0b528-dff5-4cc8-a4ed-6111096a5859", "url": "https://ll.thespacedevs.com/2.3.0/launches/22e0b528-dff5-4cc8-a4ed-6111096a5859/?format=api", "name": "Little Joe II | A-001", "response_mode": "detailed", "slug": "little-joe-ii-a-001", "launch_designator": null, "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:30:58Z", "net": "1964-05-13T12:59:59Z", "net_precision": null, "window_end": "1964-05-13T12:59:59Z", "window_start": "1964-05-13T12:59:59Z", "image": { "id": 1762, "name": "[AUTO] Little Joe II - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_ii_image_20210901072351.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193710.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "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": 7424, "configuration": { "response_mode": "detailed", "id": 470, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/470/?format=api", "name": "Little Joe II", "families": [ { "response_mode": "detailed", "id": 105, "name": "Little Joe", "manufacturer": [ { "response_mode": "normal", "id": 1004, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1004/?format=api", "name": "Convair", "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": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": 1943, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "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/Convair", "social_media_links": [] }, { "response_mode": "normal", "id": 999, "url": "https://ll.thespacedevs.com/2.3.0/agencies/999/?format=api", "name": "North American Aviation", "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": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.", "administrator": null, "founding_year": 1928, "launchers": "North American X-15", "spacecraft": "", "parent": "Boeing", "image": null, "logo": { "id": 164, "name": "[AUTO] North American Aviation - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185049.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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": 20, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 20, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/North_American_Aviation", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1959-08-21", "total_launch_count": 13, "consecutive_successful_launches": 1, "successful_launches": 7, "failed_launches": 6, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Little Joe II", "variant": "II", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1004, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1004/?format=api", "name": "Convair", "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": "Convair, previously Consolidated Vultee, was an American aircraft manufacturing company that later expanded into rockets and spacecraft. The company was formed in 1943 by the merger of Consolidated Aircraft and Vultee Aircraft. In 1953 it was purchased by General Dynamics, and operated as their Convair Division for most of its corporate history.", "administrator": null, "founding_year": 1943, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "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/Convair", "social_media_links": [] }, "program": [ { "response_mode": "normal", "id": 4, "url": "https://ll.thespacedevs.com/2.3.0/programs/4/?format=api", "name": "Apollo", "image": { "id": 1877, "name": "[AUTO] Apollo - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/apollo_program_20200820200202.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194019.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "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": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "reusable": false, "image": { "id": 1762, "name": "[AUTO] Little Joe II - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/little_joe_ii_image_20210901072351.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193710.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Little_Joe_II", "description": "American rocket used from 1963 to 1966 for five uncrewed suborbital tests of the Apollo spacecraft launch escape system and of the command module parachute recovery system in abort mode.", "alias": "", "min_stage": 1, "max_stage": 1, "length": 26.2, "diameter": 3.9, "maiden_flight": "1963-08-28", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 5, "consecutive_successful_launches": 1, "successful_launches": 4, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P161DT22H1M4S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5813, "name": "A-001", "type": "Test Flight", "description": "Second abort test of the Apollo spacecraft.", "image": null, "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 194, "url": "https://ll.thespacedevs.com/2.3.0/pads/194/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 165, "url": "https://ll.thespacedevs.com/2.3.0/agencies/165/?format=api", "name": "US Army", "abbrev": "USA", "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": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null } ], "name": "Launch Complex 36", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/White_Sands_Launch_Complex_36", "map_url": "https://www.google.com/maps?q=32.416944,-106.321944", "latitude": 32.416944, "longitude": -106.321944, "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_launch_complex_36_20210901072730.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P161DT22H1M4S", "location": { "response_mode": "normal", "id": 155, "url": "https://ll.thespacedevs.com/2.3.0/locations/155/?format=api", "name": "White Sands Missile Range", "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": 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": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.", "image": { "id": 2229, "name": "Space Shuttle Columbia landing at White Sands (STS-3)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_c_image_20240920084425.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_c_image_thumbnail_20240920084425.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": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg", "longitude": -106.405833, "latitude": 32.335556, "timezone_name": "America/Denver", "total_launch_count": 5, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 4, "url": "https://ll.thespacedevs.com/2.3.0/programs/4/?format=api", "name": "Apollo", "image": { "id": 1877, "name": "[AUTO] Apollo - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/apollo_program_20200820200202.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194019.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "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": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 52, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 3, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P258DT20H59M57S", "mission_patches": [] }
