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/82e754cc-c893-4992-a992-c1b3db972c80/?format=api
{ "id": "82e754cc-c893-4992-a992-c1b3db972c80", "url": "https://ll.thespacedevs.com/2.3.0/launches/82e754cc-c893-4992-a992-c1b3db972c80/?format=api", "name": "Black Brant IX | DEUCE", "response_mode": "detailed", "slug": "black-brant-ix-deuce", "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-11T11:01:00Z", "net_precision": null, "window_end": "2022-07-11T14:45:00Z", "window_start": "2022-07-11T10:57: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": 7612, "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": 6098, "name": "DEUCE", "type": "Astrophysics", "description": "The Dual-channel Extreme Ultraviolet Continuum Experiment (DEUCE) is a payload from the University of Colorado. its objective is to observe α Centauri A & B and measure a so-far unstudied part of their extreme ultraviolet light spectrum. These measurements are needed to model stars similar to and smaller than our Sun, as well as understand their effects on planetary atmospheres.", "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": 7161, "successful_launches": 6618, "failed_launches": 543, "total_attempted_landings": 1110, "successful_landings": 1067, "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": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "flightclub_url": null, "updates": [ { "id": 2060, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Launch successful", "info_url": "https://twitter.com/ela_space/status/1546462109403590657", "created_by": "Jay", "created_on": "2022-07-11T12:08:08Z" }, { "id": 2059, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Liftoff", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T11:01:34Z" }, { "id": 2058, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Hold released, new T-0 roughly 11:01 UTC", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T10:57:16Z" }, { "id": 2057, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Holding to sync clocks", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T10:55:31Z" }, { "id": 2056, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Webcast live", "info_url": "https://www.youtube.com/watch?v=l-J5NTUEtJk", "created_by": "Jay", "created_on": "2022-07-11T10:26:39Z" }, { "id": 1961, "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-25T19:05:44Z" } ], "info_urls": [ { "priority": 10, "source": null, "title": "NASA Wallops Flight Facility - Sounding Rockets Program Office Code 810", "description": "DEUCE will observe α Centauri A and B. DEUCE will measure a so-far unstudied part of their extreme ultraviolet light spectrum. These measurements are needed to model stars similar to and smaller than our Sun, as well as understand their effects on planetary atmospheres.\n\nThe Principal Investigator i...", "feature_image": null, "url": "https://sites.wff.nasa.gov/code810/news/story255-36.350%20DEUCE.html", "type": null, "language": null } ], "vid_urls": [ { "priority": 9, "source": null, "publisher": null, "title": "NASA Launch 3", "description": "NASA’s third space launch from a commercial spaceport for scientific astrophysics missions.", "feature_image": "https://i.ytimg.com/vi/l-J5NTUEtJk/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=l-J5NTUEtJk", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P4DT21H7M", "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" } ] }
