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/055fa36b-74c4-4fc5-809e-d123f7781df8/?format=api
{ "id": "055fa36b-74c4-4fc5-809e-d123f7781df8", "url": "https://ll.thespacedevs.com/2.3.0/launches/055fa36b-74c4-4fc5-809e-d123f7781df8/?format=api", "name": "Black Brant IX | SISTINE", "response_mode": "detailed", "slug": "black-brant-ix-sistine", "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:31:05Z", "net": "2022-07-06T13:54:00Z", "net_precision": null, "window_end": "2022-07-06T13:54:00Z", "window_start": "2022-07-06T13:54:00Z", "image": { "id": 1707, "name": "[AUTO] Black Brant IX - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_brant_ix_image_20220625190201.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193539.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": 1038, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1038/?format=api", "name": "Equatorial Launch Australia", "abbrev": "ELA", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" } ], "description": "Equatorial Launch Australia (ELA) is an Australian startup founded in 2015 to provide commercial space launches from the Arnhem Land spaceport.", "administrator": "CEO: Michael Jones", "founding_year": 2015, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 129, "name": "[AUTO] Equatorial Launch Australia - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_logo_20220912001304.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184945.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 54, "name": "[AUTO] Equatorial Launch Australia - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_nation_20220622154855.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184752.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "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": "https://ela.space/", "wiki_url": null, "social_media_links": [] }, "rocket": { "id": 7611, "configuration": { "response_mode": "detailed", "id": 481, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/481/?format=api", "name": "Black Brant IX", "families": [], "full_name": "Black Brant IX", "variant": "IX", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1039, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1039/?format=api", "name": "Magellan Aerospace Corporation", "abbrev": "MAC", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 26, "name": "Canada", "alpha_2_code": "CA", "alpha_3_code": "CAN", "nationality_name": "Canadian", "nationality_name_composed": "Canado" } ], "description": "Magellan Aerospace Corporation is a Canadian manufacturer of aerospace systems and components.", "administrator": "CEO: Phillip Underwood", "founding_year": 1996, "launchers": "Black Brant", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 157, "name": "[AUTO] Magellan Aerospace Corporation - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_logo_20220622160105.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185034.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 74, "name": "[AUTO] Magellan Aerospace Corporation - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_nation_20220622160105.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184820.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://magellan.aero/", "wiki_url": "https://en.wikipedia.org/wiki/Magellan_Aerospace", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1707, "name": "[AUTO] Black Brant IX - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_brant_ix_image_20220625190201.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193539.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/Black_Brant_(rocket)#Black_Brant_IX", "description": "The Black Brant IX is a Canadian-designed sounding rocket used by the CSA and NASA.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 12.2, "diameter": 0.46, "maiden_flight": "1982-03-16", "launch_cost": null, "launch_mass": 2.0, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": 300.0, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P4DT21H7M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 6097, "name": "SISTINE", "type": "Astrophysics", "description": "The Suborbital Imaging Spectrograph for Transition region Irradiance from Nearby Exoplanet host stars (SISTINE) is a payload from the University of Colorado. Its objective is to study how light from stars affects the atmospheres of the planets around them, including the gases thought to be signs of life. For this flight, it will measure the ultraviolet light output from α Centauri A and B, two stars of the three-star α Centauri system that are the closest stars to our Sun.", "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": 202, "url": "https://ll.thespacedevs.com/2.3.0/pads/202/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 1038, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1038/?format=api", "name": "Equatorial Launch Australia", "abbrev": "ELA", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" } ], "description": "Equatorial Launch Australia (ELA) is an Australian startup founded in 2015 to provide commercial space launches from the Arnhem Land spaceport.", "administrator": "CEO: Michael Jones", "founding_year": 2015, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 129, "name": "[AUTO] Equatorial Launch Australia - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_logo_20220912001304.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184945.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 54, "name": "[AUTO] Equatorial Launch Australia - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_nation_20220622154855.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184752.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Suborbital Launch Ramp", "image": null, "description": null, "info_url": "https://ela.space/arnhem-space-centre/", "wiki_url": "https://en.wikipedia.org/wiki/Arnhem_Land#Economy", "map_url": "https://www.google.com/maps?q=-12.3892948,136.7903215", "latitude": -12.3892948, "longitude": 136.7903215, "country": { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_suborbital_launch_ramp_20220625184504.jpg", "total_launch_count": 3, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P4DT21H7M", "location": { "response_mode": "normal", "id": 160, "url": "https://ll.thespacedevs.com/2.3.0/locations/160/?format=api", "name": "Arnhem Space Centre", "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": false, "country": { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" }, "description": "The Arnhem Space Centre was Australia's first commercial spaceport, located near Nhulunbuy, in Arnhem Land, Australia. It was owned and operated by Equatorial Launch Australia (ELA), and was the site of NASA's first non-orbital sounding rocket launch from a commercial port outside the United States on 27 June 2022.", "image": { "id": 2197, "name": "Arnhem Space Centre", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arnhem_space_ce_image_20240918150330.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arnhem_space_ce_image_thumbnail_20240918150331.jpeg", "credit": "Equatorial Launch Australia", "license": { "id": 29, "name": "ELA Image Use Policy", "priority": 8, "link": "https://ela.space/website-disclaimer" }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_arnhem_space_centre_20220622160552.jpg", "longitude": 136.813889, "latitude": -12.381389, "timezone_name": "Australia/Darwin", "total_launch_count": 3, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "flightclub_url": null, "updates": [ { "id": 2037, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch success confirmed. Exact T-0 unclear.", "info_url": "https://twitter.com/ela_space/status/1544684744822374401", "created_by": "Nosu", "created_on": "2022-07-06T14:14:52Z" }, { "id": 2036, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch on hold due to unfavorable weather conditions.", "info_url": "https://twitter.com/ela_space/status/1544670112837275648", "created_by": "Nosu", "created_on": "2022-07-06T13:11:40Z" }, { "id": 2035, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Setting GO", "info_url": "https://twitter.com/ela_space/status/1544542661151195136", "created_by": "Nosu", "created_on": "2022-07-06T08:20:00Z" }, { "id": 2031, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Scrub due to bad weather", "info_url": "https://twitter.com/ela_space/status/1544288974071824384", "created_by": "Nosu", "created_on": "2022-07-05T12:03:47Z" }, { "id": 2026, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Delayed 24 hours due to weather", "info_url": "https://twitter.com/ela_space/status/1543740709567877120", "created_by": "Jay", "created_on": "2022-07-03T23:58:38Z" }, { "id": 1960, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch per request of the Australian Space Agency.", "info_url": "https://ela.space/ela-and-nasa-to-conduct-australias-first-ever-commercial-space-launch/", "created_by": "Nosu", "created_on": "2022-06-25T18:59:36Z" } ], "info_urls": [ { "priority": 10, "source": null, "title": "NASA Wallops Flight Facility - Sounding Rockets Program Office Code 810", "description": "SISTINE will study how light from stars affects the atmospheres of the planets around them, including the gases thought to be signs of life. For the upcoming flight, SISTINE will measure the ultraviolet light output from α Centauri A and B, two stars of the three-star α Centauri system that are the ...", "feature_image": null, "url": "https://sites.wff.nasa.gov/code810/news/story253-36.339%20SISTINE.html", "type": null, "language": null } ], "vid_urls": [], "timeline": [], "pad_turnaround": "P9DT23H24M", "mission_patches": [ { "id": 639, "name": "NASA XQC, SISTINE & DEUCE", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nasa2520xqc_mission_patch_20220625185212.png", "agency": { "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" } }, "response_mode": "normal" } ] }
