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/ffa5b63e-72b1-4a55-801e-084464db15b1/?format=api
{ "id": "ffa5b63e-72b1-4a55-801e-084464db15b1", "url": "https://ll.thespacedevs.com/2.3.0/launches/ffa5b63e-72b1-4a55-801e-084464db15b1/?format=api", "name": "Titan IIIC | IDCSP 8 to 14", "response_mode": "detailed", "slug": "titan-iiic-idcsp-8-to-14", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T17:42:35Z", "net": "1966-08-26T13:59:56Z", "net_precision": null, "window_end": "1966-08-26T13:59:56Z", "window_start": "1966-08-26T13:59:56Z", "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": 3565, "configuration": { "response_mode": "detailed", "id": 439, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/439/?format=api", "name": "Titan IIIC", "families": [ { "response_mode": "detailed", "id": 70, "name": "Titan", "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": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1964-04-08", "total_launch_count": 220, "consecutive_successful_launches": 18, "successful_launches": 205, "failed_launches": 15, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, { "response_mode": "detailed", "id": 196, "name": "Titan III", "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": [] } ], "parent": { "response_mode": "normal", "id": 70, "name": "Titan", "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 } ], "parent": null }, "description": "", "active": false, "maiden_flight": "1964-09-01", "total_launch_count": 156, "consecutive_successful_launches": 11, "successful_launches": 146, "failed_launches": 10, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Titan IIIC", "variant": "IIIC", "active": false, "is_placeholder": false, "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": [] }, "program": [], "reusable": false, "image": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Titan_IIIC", "description": "The Titan IIIC was an expendable launch system used by the United States Air Force from 1965 until 1982. It was the first Titan booster to feature large solid rocket motors and was planned to be used as a launcher for the Dyna-Soar, though the spaceplane was cancelled before it could fly. The majority of the launcher's payloads were DoD satellites, for military communications and early warning, though one flight (ATS-6) was performed by NASA. The Titan IIIC was launched exclusively from Cape Canaveral while its sibling, the Titan IIID, was launched only from Vandenberg AFB.", "alias": "", "min_stage": 2, "max_stage": 3, "length": 42.0, "diameter": 3.0, "maiden_flight": "1965-06-18", "launch_cost": null, "launch_mass": 626.0, "leo_capacity": 13100.0, "gto_capacity": 3000.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": 10586.0, "apogee": null, "total_launch_count": 36, "consecutive_successful_launches": 8, "successful_launches": 34, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P50DT14H47M36S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1985, "name": "IDCSP 8 to 14", "type": "Communications", "description": "The IDCSP (Initial Defense Communications satellite Program) provided the Pentagon with its first near-geosynchronous communications system and replaced the cancelled ADVENT project.", "image": null, "orbit": { "id": 3, "name": "Geosynchronous Orbit", "abbrev": "GSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.3.0/pads/29/?format=api", "active": true, "agencies": [], "name": "Space Launch Complex 41", "image": { "id": 1394, "name": "Atlas V 541 on the pad (Mars 2020/Perseverance rover & Ingenuity helicopter)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v252_image_20200729144937.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192627.jpeg", "credit": "United Launch Alliance", "license": { "id": 10, "name": "ULA Image Use Policy", "priority": 3, "link": "https://www.ulalaunch.com/terms-and-conditions" }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": 28.58341025, "longitude": -80.58303644, "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_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115, "fastest_turnaround": "P15DT22H26M17S", "location": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api", "name": "Cape Canaveral SFS, FL, 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": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "image": { "id": 2200, "name": "Cape Canaveral & KSC seen from orbit (STS-43)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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_12_20200803142519.jpg", "longitude": -80.577778, "latitude": 28.488889, "timezone_name": "America/New_York", "total_launch_count": 1019, "total_landing_count": 64 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 603, "location_launch_attempt_count": 181, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 347, "orbital_launch_attempt_count_year": 86, "location_launch_attempt_count_year": 22, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 48, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P70DT23H59M55S", "mission_patches": [] }
