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/ca04d7d9-73dc-457f-8fae-512ef0fc2a88/?format=api
{ "id": "ca04d7d9-73dc-457f-8fae-512ef0fc2a88", "url": "https://ll.thespacedevs.com/2.2.0/launch/ca04d7d9-73dc-457f-8fae-512ef0fc2a88/?format=api", "slug": "h-iia-2022-daichi", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 2022 | Daichi", "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-14T03:53:10Z", "updates": [], "net": "2006-01-24T01:33:00Z", "net_precision": null, "window_end": "2006-01-24T01:33:00Z", "window_start": "2006-01-24T01:33:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "featured": true, "type": "Government", "country_code": "JPN", "abbrev": "JAXA", "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.", "administrator": "Administrator: Hiroshi Yamakawa", "founding_year": "2003", "launchers": "H-II", "spacecraft": "", "launch_library_url": null, "total_launch_count": 37, "consecutive_successful_launches": 2, "successful_launches": 33, "failed_launches": 4, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.jaxa.jp/", "wiki_url": "https://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png" }, "rocket": { "id": 7254, "configuration": { "id": 321, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/321/?format=api", "name": "H-IIA", "active": false, "reusable": false, "description": "The H-IIA rocket family is an expendable launch system operated by Mitsubishi Heavy Industries for the Japan Aerospace Exploration Agency. The liquid fuelled rocket has been used to launch satellites, lunar spacecraft and planetary science craft.", "family": "H-II", "full_name": "H-IIA 2022", "manufacturer": { "id": 98, "url": "https://ll.thespacedevs.com/2.2.0/agencies/98/?format=api", "name": "Mitsubishi Heavy Industries", "featured": false, "type": "Commercial", "country_code": "JPN", "abbrev": "MHI", "description": "Mitsubishi Heavy Industries, Ltd. is a Japanese multinational engineering, electrical equipment and electronics company headquartered in Tokyo, Japan. MHI is one of the core companies of the Mitsubishi Group.\r\n\r\nMHI's products include aerospace components, air conditioners, aircraft, automotive components, forklift trucks, hydraulic equipment, machine tools, missiles, power generation equipment, printing machines, ships and space launch vehicles. Through its defense-related activities, it is the world's 23rd-largest defense contractor measured by 2011 defense revenues and the largest based in Japan.", "administrator": "President: Seiji Izumisawa", "founding_year": "1884", "launchers": "H-I, H-II, H-III", "spacecraft": "Kounotori | HTV", "launch_library_url": null, "total_launch_count": 56, "consecutive_successful_launches": 0, "successful_launches": 54, "failed_launches": 2, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.mhi.com/", "wiki_url": "https://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "program": [], "variant": "2022", "alias": "", "min_stage": 2, "max_stage": 2, "length": 53.0, "diameter": 4.0, "maiden_flight": "2005-02-26", "launch_cost": null, "launch_mass": 316, "leo_capacity": null, "gto_capacity": 4500, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-ii_2022_lifto_image_20240411175401.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/H-IIA", "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 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 5643, "name": "Daichi", "description": "ALOS (Advanced Land Observation Satellite) is used for cartography, regional observation, disaster monitoring, and resource surveying.\r\n\r\nALOS has three remote-sensing instruments:\r\n\r\n- the Panchromatic Remote-sensing Instrument for Stereo Mapping (PRISM) for digital elevation mapping with 2.5 meter resolution,\r\n- the Advanced Visible and Near Infrared Radiometer type 2 (AVNIR-2) for precise land coverage observation with 10 meter resolution, and\r\n- the Phased Array type L-band Synthetic Aperture Radar (PALSAR) for day-and-night and all-weather land observation.\r\n\r\nALOS transmitts its data via the DRTS (Kodama) satellite.\r\n\r\nThe ALOS was launched by an H-2A-2022 launch vehicle from the Tanegashima Space Center. ALOS as been given the nickname Daichi.\r\n\r\nFive minutes after spacecraft separation, ALOS began to unfurl its 72-foot solar array that will provide electrical power to the craft throughout its mission. Six cameras are on-board to visually verify the correct deployment of the solar panel and various instrument antennas.\r\n\r\nALOS lost all power on 22. April 2011, thus ending the mission.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/pad/41/?format=api", "agency_id": 37, "name": "Yoshinobu Launch Complex LP-1", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex", "map_url": "https://www.google.com/maps?q=30.400813,130.977748", "latitude": "30.400813", "longitude": "130.977748", "location": { "id": 26, "url": "https://ll.thespacedevs.com/2.2.0/location/26/?format=api", "name": "Tanegashima Space Center, Japan", "country_code": "JPN", "description": "The Tanegashima Space Center is the largest rocket-launch complex in Japan. It is located on the southeastern tip of Tanegashima, an island located south of Kyushu, an island and region and Japan. It was established in 1969 when the National Space Development Agency of Japan (NASDA) was formed, and is now run by JAXA. The activities that take place at TNSC include assembly, testing, launching, and tracking satellites, as well as rocket engine firing tests.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg", "timezone_name": "Asia/Tokyo", "total_launch_count": 97, "total_landing_count": 0 }, "country_code": "JPN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg", "total_launch_count": 57, "orbital_launch_attempt_count": 57 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-ii_2022_lifto_image_20240411175401.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 4752, "location_launch_attempt_count": 39, "pad_launch_attempt_count": 15, "agency_launch_attempt_count": 16, "orbital_launch_attempt_count_year": 2, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P331DT16H8M", "mission_patches": [], "type": "detailed" }
