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/0434abc8-ff40-49a3-b0de-9590e0811ee2/?format=api
{ "id": "0434abc8-ff40-49a3-b0de-9590e0811ee2", "url": "https://ll.thespacedevs.com/2.3.0/launches/0434abc8-ff40-49a3-b0de-9590e0811ee2/?format=api", "name": "Atlas Agena D | KH-7 3", "response_mode": "detailed", "slug": "atlas-agena-d-kh-7-3", "launch_designator": "1963-041", "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:26:28Z", "net": "1963-10-25T18:59:27Z", "net_precision": null, "window_end": "1963-10-25T18:59:27Z", "window_start": "1963-10-25T18:59:27Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "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": [] }, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "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": "http://www.af.mil", "wiki_url": "http://en.wikipedia.org/wiki/United_States_Air_Force", "social_media_links": [] }, "rocket": { "id": 3231, "configuration": { "response_mode": "detailed", "id": 232, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/232/?format=api", "name": "Atlas Agena D", "families": [ { "response_mode": "detailed", "id": 66, "name": "Atlas", "manufacturer": [ { "response_mode": "normal", "id": 82, "url": "https://ll.thespacedevs.com/2.3.0/agencies/82/?format=api", "name": "Lockheed Martin", "abbrev": "LMT", "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": "Lockheed Martin's Space Division started in the production of missiles and later ICBM's in the 1950s. Their TITAN missile system was used for 12 Gemini spacecraft and the Voyager probes. They have worked largely in collaboration with NASA on many of their probes, landers, and spacecraft, and hope to play a key role in NASA's return to the moon in 2024.", "administrator": null, "founding_year": 1953, "launchers": "Titan | Agena", "spacecraft": "Hubble | JUNO | InSight", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 80, "consecutive_successful_launches": 38, "successful_launches": 77, "failed_launches": 3, "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": "http://www.lockheedmartin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Lockheed_Martin", "social_media_links": [] }, { "response_mode": "normal", "id": 124, "url": "https://ll.thespacedevs.com/2.3.0/agencies/124/?format=api", "name": "United Launch Alliance", "abbrev": "ULA", "type": { "id": 3, "name": "Commercial" }, "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": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": 2006, "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "parent": null, "image": { "id": 30, "name": "[AUTO] United Launch Alliance - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184706.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 191, "name": "[AUTO] United Launch Alliance - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185148.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 97, "name": "[AUTO] United Launch Alliance - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184852.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "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": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1958-12-18", "total_launch_count": 436, "consecutive_successful_launches": 178, "successful_launches": 399, "failed_launches": 37, "pending_launches": 14, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Atlas LV-3 Agena D", "variant": "Agena D", "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": [], "reusable": false, "image": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Atlas-Agena", "description": "The Atlas-Agena was an American expendable launch system derived from the SM-65 Atlas missile. It was a member of the Atlas family of rockets, and was launched 109 times between 1960 and 1978.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 36.0, "diameter": 3.0, "maiden_flight": "1963-07-12", "launch_cost": null, "launch_mass": 155.0, "leo_capacity": 1000.0, "gto_capacity": null, "geo_capacity": 700.0, "sso_capacity": null, "to_thrust": 1340.0, "apogee": null, "total_launch_count": 15, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P8DT16H22M27S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1653, "name": "KH-7 3", "type": "Government/Top Secret", "description": "The Program 206 satellite, carrying the KH-7 (Keyhole 7) camera system (codenamed Gambit-1), was the first successful high resolution space reconnaissance program. It was managed by NRO's Program A, the USAF-led segment of the National Reconnaissance Program managed from Los Angeles AFB in El Segundo, California.", "image": null, "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 156, "url": "https://ll.thespacedevs.com/2.3.0/pads/156/?format=api", "active": false, "agencies": [], "name": "Space Launch Complex 4W", "image": { "id": 2249, "name": "Titan II SLV liftoff from SLC-4W (NOAA 15)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/titan_ii_slv_li_image_20240922120444.JPG", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/titan_ii_slv_li_image_thumbnail_20240922120444.jpeg", "credit": "USAF", "license": { "id": 17, "name": "Department of Defense Image Use Policy", "priority": 6, "link": "https://www.dimoc.mil/resources/limitations/" }, "single_use": false, "variants": [] }, "description": "SLC-4W started operations in 1963 as Space Launch Complex 4W, and continued as an operational launch site through 2003. In 2015, SpaceX started conversion of the launch site into Landing Zone LZ-4. Landing operations commenced in 2018 at LZ-4.", "info_url": "http://www.astronautix.com/v/vandenbergslc4w.html", "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Air_Force_Base_Space_Launch_Complex_4#SLC-4W", "map_url": "https://www.google.com/maps?q=34.63312,-120.61584", "latitude": 34.63312, "longitude": -120.61584, "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_156_20200803143351.jpg", "total_launch_count": 93, "orbital_launch_attempt_count": 93, "fastest_turnaround": "P15DT1H14M37S", "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": 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": "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": 277, "location_launch_attempt_count": 110, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 166, "orbital_launch_attempt_count_year": 53, "location_launch_attempt_count_year": 28, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 40, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P48DT23H29M9S", "mission_patches": [] }
