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/7533059e-732d-4ee5-9f5d-2974f85b9e88/?format=api
{ "id": "7533059e-732d-4ee5-9f5d-2974f85b9e88", "url": "https://ll.thespacedevs.com/2.3.0/launches/7533059e-732d-4ee5-9f5d-2974f85b9e88/?format=api", "name": "Black Brant IX | XQC", "response_mode": "detailed", "slug": "black-brant-ix-xqc", "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:06Z", "net": "2022-06-26T14:30:00Z", "net_precision": null, "window_end": "2022-06-26T16:14:00Z", "window_start": "2022-06-26T13:14: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": 7610, "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": 6096, "name": "XQC", "type": "Astrophysics", "description": "The X-ray Quantum Calorimeter Experiment (XQC) is a payload from the University of Wisconsin. Its objective is to measure X-rays with unprecedented precision to better understand the interstellar medium and its influence on the structure and evolution of galaxies and stars.", "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": 7162, "successful_launches": 6618, "failed_launches": 544, "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": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [ { "id": 1976, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful launch confirmed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:40:10Z" }, { "id": 1975, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:30:00Z" }, { "id": 1974, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:28:34Z" }, { "id": 1973, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-03:00", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:06:04Z" }, { "id": 1972, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:04:38Z" }, { "id": 1971, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-3 minutes", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:58:55Z" }, { "id": 1970, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:57:20Z" }, { "id": 1969, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-03:00", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:51:53Z" }, { "id": 1968, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:51:13Z" }, { "id": 1967, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Hold at T-3 minutes", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:45:40Z" }, { "id": 1966, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Delayed by half an hour.", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T12:38:56Z" }, { "id": 1964, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Webcast live", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T12:18:13Z" }, { "id": 1959, "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:54:07Z" } ], "info_urls": [ { "priority": 10, "source": null, "title": "NASA Wallops Flight Facility - Sounding Rockets Program Office Code 810", "description": "The night sky glows with X-ray light coming from all directions. Much of this X-ray light is produced by the interstellar medium, which includes hot gases filling the space between the stars. The unique X-ray detectors on this mission, cooled to a frigid one-twentieth of a degree above absolute zero...", "feature_image": null, "url": "https://sites.wff.nasa.gov/code810/news/story254-36.347%20XQC.html", "type": null, "language": null } ], "vid_urls": [ { "priority": 10, "source": null, "publisher": null, "title": "NASA Launch 1", "description": "NASA’s first ever space launch from a commercial spaceport for scientific astrophysics missions. This first of three launches welcomes University of Wisconsi...", "feature_image": "https://i.ytimg.com/vi/lSfugtxlXmw/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P0D", "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" } ] }
