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/8bd239c0-2ca4-4e43-8dd8-b9a299e6fb0f/?format=api
{ "id": "8bd239c0-2ca4-4e43-8dd8-b9a299e6fb0f", "url": "https://ll.thespacedevs.com/2.3.0/launches/8bd239c0-2ca4-4e43-8dd8-b9a299e6fb0f/?format=api", "name": "Neutron | NZSA Venus Mission", "response_mode": "detailed", "slug": "neutron-nzsa-venus-mission", "launch_designator": null, "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-11-15T18:02:11Z", "net": "2026-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "image": { "id": 1793, "name": "[AUTO] Neutron - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/neutron_image_20230727171443.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193800.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": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 63, "consecutive_successful_launches": 22, "successful_launches": 59, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "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.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "social_media_links": [] }, "rocket": { "id": 8056, "configuration": { "response_mode": "detailed", "id": 476, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/476/?format=api", "name": "Neutron", "families": [], "full_name": "Neutron", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 63, "consecutive_successful_launches": 22, "successful_launches": 59, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "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.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "social_media_links": [] }, "program": [], "reusable": true, "image": { "id": 1793, "name": "[AUTO] Neutron - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/neutron_image_20230727171443.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193800.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.rocketlabusa.com/launch/neutron/", "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Neutron", "description": "Neutron is an upcoming medium-lift two-stage launch vehicle under development by Rocket Lab. Neutron features a reusable first stage fueled by LOX and Methane.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 40.0, "diameter": 7.0, "maiden_flight": null, "launch_cost": null, "launch_mass": 480.0, "leo_capacity": 15000.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 5960.0, "apogee": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 6609, "name": "NZSA Venus Mission", "type": "Planetary Science", "description": "NZSA Venus Mission is a small direct Venus entry probe with a single 1 kg low-mass, low-cost autofluorescing nephelometer riding on a satellite bus based on the Photon Upper stage of the Electron rocket.\r\n\r\nThe probe mission will spend approximately 5 minutes in the Venus cloud layers, 48-60 km above the surface, collecting in situ measurements to search for organic molecules in cloud particles and constrain particle composition.", "image": null, "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 234, "url": "https://ll.thespacedevs.com/2.3.0/pads/234/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Rocket Lab Launch Complex 3 (Launch Area 0 D)", "image": null, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=37.8321693,-75.4899046", "latitude": 37.8321693, "longitude": -75.4899046, "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_rocket_lab_launch_complex_3_2528launch_area_0_d2529_20241115175136.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 21, "url": "https://ll.thespacedevs.com/2.3.0/locations/21/?format=api", "name": "Wallops Flight Facility, Virginia, 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": "Wallops Flight Facility is a rocket launch site on Wallops Island on the Eastern Shore of Virginia, United States, just east of the Delmarva Peninsula and north-northeast of Norfolk. The facility is operated by the Goddard Space Flight Center in Greenbelt, Maryland, and primarily serves to support science and exploration missions for NASA and other federal agencies. WFF includes an extensively instrumented range to support launches of more than a dozen types of sounding rockets; small expendable suborbital and orbital rockets; high-altitude balloon flights carrying scientific instruments for atmospheric and astronomical research; and, using its Research Airport, flight tests of aeronautical research aircraft, including uncrewed aerial vehicles.", "image": { "id": 2227, "name": "Wallops Flight Facility", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/wallops_flight__image_20240920083715.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/wallops_flight__image_thumbnail_20240920083715.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_21_20200803142423.jpg", "longitude": -75.467778, "latitude": 37.933333, "timezone_name": "America/New_York", "total_launch_count": 80, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 7197, "location_launch_attempt_count": 92, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 92, "orbital_launch_attempt_count_year": 86, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 6, "flightclub_url": null, "updates": [ { "id": 9214, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Switch in launch vehicle planned.", "info_url": "https://www.youtube.com/watch?v=MO9y8HsEgKk", "created_by": "Cosmic_Penguin", "created_on": "2024-11-15T18:02:00Z" }, { "id": 9211, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2026.", "info_url": "https://x.com/scotto2050/status/1857220373907165463", "created_by": "Cosmic_Penguin", "created_on": "2024-11-15T15:52:00Z" }, { "id": 5546, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://twitter.com/SpcPlcyOnline/status/1719106829349704017", "created_by": "Cosmic_Penguin", "created_on": "2023-10-31T02:14:44Z" } ], "info_urls": [ { "priority": 10, "source": "arxiv.org", "title": "Rocket Lab Mission to Venus", "description": "", "feature_image": null, "url": "https://arxiv.org/abs/2208.07724", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vid_urls": [], "timeline": [], "pad_turnaround": "P365D", "mission_patches": [] }
