Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/23e92c1c-1c4f-469c-8cf0-74200a6b05c8/?format=api
{ "id": "23e92c1c-1c4f-469c-8cf0-74200a6b05c8", "url": "https://ll.thespacedevs.com/2.2.0/launch/23e92c1c-1c4f-469c-8cf0-74200a6b05c8/?format=api", "slug": "hapith-i-test-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Hapith I | Test Flight", "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", "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" } ], "net": "2021-09-16T06:39:00Z", "net_precision": null, "window_end": "2021-09-16T08:30:00Z", "window_start": "2021-09-15T20:45:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1029, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1029/?format=api", "name": "TiSPACE", "featured": false, "type": "Private", "country_code": "TWN", "abbrev": "", "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": "", "launch_library_url": null, "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, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/TiSPACE", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_logo_20210910043519.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_nation_20210910043519.png" }, "rocket": { "id": 7450, "configuration": { "id": 474, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/474/?format=api", "name": "Hapith I", "active": true, "reusable": false, "description": "Hapith I is a sub-orbital launch vehicle built by TiSPACE. It is intended to test technologies for the future Hapith V vehicle.", "family": "", "full_name": "Hapith I", "manufacturer": { "id": 1029, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1029/?format=api", "name": "TiSPACE", "featured": false, "type": "Private", "country_code": "TWN", "abbrev": "", "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": "", "launch_library_url": null, "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, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/TiSPACE", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_logo_20210910043519.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tispace_nation_20210910043519.png" }, "program": [], "variant": "I", "alias": "", "min_stage": 2, "max_stage": 2, "length": 10.2, "diameter": 2.2, "maiden_flight": "2021-09-16", "launch_cost": null, "launch_mass": 3, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hapith_i_image_20210911031658.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/TiSPACE#HAPITH_I", "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 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 5842, "name": "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.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 197, "url": "https://ll.thespacedevs.com/2.2.0/pad/197/?format=api", "agency_id": 1028, "name": "Pad 1", "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", "location": { "id": 156, "url": "https://ll.thespacedevs.com/2.2.0/location/156/?format=api", "name": "Whalers Way Orbital Launch Complex, South Australia", "country_code": "AUS", "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.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_whalers_way_orbital_launch_complex_20210910042508.jpg", "timezone_name": "Australia/Adelaide", "total_launch_count": 1, "total_landing_count": 0 }, "country_code": "AUS", "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 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hapith_i_image_20210911031658.jpg", "infographic": null, "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, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
