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/23e92c1c-1c4f-469c-8cf0-74200a6b05c8/?format=api
{ "id": "23e92c1c-1c4f-469c-8cf0-74200a6b05c8", "url": "https://ll.thespacedevs.com/2.3.0/launches/23e92c1c-1c4f-469c-8cf0-74200a6b05c8/?format=api", "name": "Hapith I | Test Flight", "response_mode": "detailed", "slug": "hapith-i-test-flight", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T04:31:02Z", "net": "2021-09-16T06:39:00Z", "net_precision": null, "window_end": "2021-09-16T08:30:00Z", "window_start": "2021-09-15T20:45:00Z", "image": { "id": 1748, "name": "[AUTO] Hapith I - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hapith_i_image_20210911031658.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193647.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": 1029, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1029/?format=api", "name": "TiSPACE", "abbrev": "", "type": { "id": 5, "name": "Private" }, "featured": false, "country": [ { "id": 76, "name": "Taiwan", "alpha_2_code": "TW", "alpha_3_code": "TWN", "nationality_name": "Taiwanese", "nationality_name_composed": "Taiwanese" } ], "description": "Taiwan Innovative Space Inc.(TiSPACE), is a space launch company from Taiwan founded in 2016.", "administrator": "Founder: Dr. Yen-Sen Chen", "founding_year": 2016, "launchers": "Hapith I, Hapith V", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 189, "name": "[AUTO] TiSPACE - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_logo_20210910043519.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185144.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 96, "name": "[AUTO] TiSPACE - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_nation_20210910043519.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184851.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/TiSPACE", "social_media_links": [] }, "rocket": { "id": 7450, "configuration": { "response_mode": "detailed", "id": 474, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/474/?format=api", "name": "Hapith I", "families": [], "full_name": "Hapith I", "variant": "I", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1029, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1029/?format=api", "name": "TiSPACE", "abbrev": "", "type": { "id": 5, "name": "Private" }, "featured": false, "country": [ { "id": 76, "name": "Taiwan", "alpha_2_code": "TW", "alpha_3_code": "TWN", "nationality_name": "Taiwanese", "nationality_name_composed": "Taiwanese" } ], "description": "Taiwan Innovative Space Inc.(TiSPACE), is a space launch company from Taiwan founded in 2016.", "administrator": "Founder: Dr. Yen-Sen Chen", "founding_year": 2016, "launchers": "Hapith I, Hapith V", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 189, "name": "[AUTO] TiSPACE - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_logo_20210910043519.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185144.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 96, "name": "[AUTO] TiSPACE - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_nation_20210910043519.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184851.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/TiSPACE", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1748, "name": "[AUTO] Hapith I - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hapith_i_image_20210911031658.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193647.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/TiSPACE#HAPITH_I", "description": "Hapith I is a sub-orbital launch vehicle built by TiSPACE. It is intended to test technologies for the future Hapith V vehicle.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 10.2, "diameter": 2.2, "maiden_flight": "2021-09-16", "launch_cost": null, "launch_mass": 3.0, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5842, "name": "Test Flight", "type": "Test Flight", "description": "The first Hapith I launch will be testing TiSPACE's hybrid rocket engine technology in preparation for the future Hapith V launch vehicle. Targeting 250 km altitude, the test launch campaign will also support of the development of the Whalers Way Orbital Launch Complex in South Australia, operated by Southern Launch.", "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": 197, "url": "https://ll.thespacedevs.com/2.3.0/pads/197/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 1028, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1028/?format=api", "name": "Southern Launch", "abbrev": "", "type": { "id": 5, "name": "Private" }, "featured": false, "country": [ { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" } ], "description": "Southern Launch is a South Australian launch company specializing in infrastructure and logistics for sub-orbital and orbital launches from Australian launch sites.", "administrator": "CEO: Lloyd Damp", "founding_year": 2017, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 181, "name": "Southern Launch logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/southern_launch_image_20240820182546.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/southern_launch_image_thumbnail_20240820182546.png", "credit": "Southern Launch", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 2182, "name": "Southern Launch social logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/southern_launch_image_20240820182607.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/southern_launch_image_thumbnail_20240820182607.jpeg", "credit": "Southern Launch", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Pad 1", "image": null, "description": null, "info_url": "https://www.southernlaunch.space/whalers-way-orbital-launch-complex", "wiki_url": "https://en.wikipedia.org/wiki/Whalers_Way_Orbital_Launch_Complex", "map_url": "https://www.google.com/maps?q=-34.937822,135.630035", "latitude": -34.937822, "longitude": 135.630035, "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_whalers_way_orbital_launch_complex_20210910042853.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 0, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 156, "url": "https://ll.thespacedevs.com/2.3.0/locations/156/?format=api", "name": "Whalers Way Orbital Launch Complex, South Australia", "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": 7164, "successful_launches": 6620, "failed_launches": 544, "total_attempted_landings": 1110, "successful_landings": 1067, "failed_landings": 43 }, "active": true, "country": { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" }, "description": "Whalers Way Orbital Launch Complex is a rocket-launching facility operated by Southern Launch at Whalers Way, in the locality of Sleaford near Port Lincoln on South Australia's Eyre Peninsula.", "image": { "id": 2228, "name": "Whalers Way Orbital Launch Complex", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/whalers_way_orb_image_20240920084054.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/whalers_way_orb_image_thumbnail_20240920084054.jpeg", "credit": "Southern Launch", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_whalers_way_orbital_launch_complex_20210910042508.jpg", "longitude": 135.65, "latitude": -34.91, "timezone_name": "Australia/Adelaide", "total_launch_count": 1, "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": 824, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "The launch vehicle caught alight at ignition and was damaged. It will not be used for any further launch attempt.", "info_url": "https://twitter.com/SouthernLaunch/status/1438406400405741570?s=19", "created_by": "Nosu", "created_on": "2021-09-16T07:41:08Z" }, { "id": 821, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown halted just before liftoff due to a technical issue. Awaiting further information for the next launch attempt.", "info_url": "https://twitter.com/SouthernLaunch/status/1438034199328354306", "created_by": "Nosu", "created_on": "2021-09-15T07:01:06Z" }, { "id": 819, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "New launch window", "info_url": "https://twitter.com/SouthernLaunch/status/1437640632848171018", "created_by": "Nosu", "created_on": "2021-09-14T05:15:48Z" } ], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
