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/ecef37b3-2e0f-4aed-a6c7-83ec526f3f64/?format=api
{ "id": "ecef37b3-2e0f-4aed-a6c7-83ec526f3f64", "url": "https://ll.thespacedevs.com/2.3.0/launches/ecef37b3-2e0f-4aed-a6c7-83ec526f3f64/?format=api", "name": "Athena I | Formosat-1", "response_mode": "detailed", "slug": "athena-i-formosat-1", "launch_designator": "1999-002", "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-14T17:42:47Z", "net": "1999-01-27T00:34:02Z", "net_precision": null, "window_end": "1999-01-27T00:34:02Z", "window_start": "1999-01-27T00:34:02Z", "image": { "id": 2056, "name": "Athena 1 liftoff from Kodiak Island", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/athena_1_liftof_image_20240411090356.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/athena_1_liftof_image_thumbnail_20240411090356.jpeg", "credit": "NASA/Kennedy Space Center Expendable Vehicle Directorate", "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": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "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": [] }, "rocket": { "id": 6898, "configuration": { "response_mode": "detailed", "id": 228, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/228/?format=api", "name": "Athena I", "families": [ { "response_mode": "detailed", "id": 65, "name": "Athena", "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": "1995-08-15", "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 5, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Athena I", "variant": "I", "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": { "id": 2056, "name": "Athena 1 liftoff from Kodiak Island", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/athena_1_liftof_image_20240411090356.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/athena_1_liftof_image_thumbnail_20240411090356.jpeg", "credit": "NASA/Kennedy Space Center Expendable Vehicle Directorate", "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": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Athena_I", "description": "The Athena I, known as the Lockheed Launch Vehicle (LLV) at the time of its first flight and Lockheed Martin Launch Vehicle (LMLV) at the time of its second flight, is an American small expendable launch system which was used for four launches between 1995 and 2001. It is a member of the Athena family of rockets, along with the larger Athena II.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 18.9, "diameter": 2.36, "maiden_flight": "1995-08-15", "launch_cost": null, "launch_mass": 66.0, "leo_capacity": 820.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 360.0, "to_thrust": 1900.0, "apogee": null, "total_launch_count": 4, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P521DT17H43M1S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5288, "name": "Formosat-1", "type": "Earth Science", "description": "The mission objective of ROCSAT-1 (Republic of China Satellite 1) is to develop, launch, and operate a low earth orbit satellite, and to conduct three scientific and technology experiments in the areas of ocean color imaging, space telecommunication, and solar-terrestrial physics.", "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": 27, "url": "https://ll.thespacedevs.com/2.3.0/pads/27/?format=api", "active": true, "agencies": [], "name": "Space Launch Complex 46", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Spaceport_Florida_Launch_Complex_46", "map_url": "https://www.google.com/maps?q=28.4584,-80.5284", "latitude": 28.4584, "longitude": -80.5284, "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_27_20200803143319.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P121DT21H43M", "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": 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": "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": 1020, "total_landing_count": 64 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4291, "location_launch_attempt_count": 558, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 39, "orbital_launch_attempt_count_year": 2, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P384DT22H5M18S", "mission_patches": [] }
