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/1017c305-e50d-4a0f-8414-f7220d36e332/?format=api
{ "id": "1017c305-e50d-4a0f-8414-f7220d36e332", "url": "https://ll.thespacedevs.com/2.2.0/launch/1017c305-e50d-4a0f-8414-f7220d36e332/?format=api", "slug": "epsilon-raise-3-others", "flightclub_url": null, "r_spacex_api_id": null, "name": "Epsilon | RAISE-3 & others", "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-08-16T06:36:33Z", "updates": [ { "id": 2577, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch failure", "info_url": "https://twitter.com/nhk_news/status/1580008356865273856?s=61&t=5J19Sfu7n2p9aXsIpqqthw", "created_by": "Cosmic_Penguin", "created_on": "2022-10-12T01:46:05Z" }, { "id": 2576, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff", "info_url": "https://youtu.be/Blai5oZQtFs", "created_by": "Cosmic_Penguin", "created_on": "2022-10-12T00:51:16Z" }, { "id": 2575, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Webcast live", "info_url": "https://youtu.be/Blai5oZQtFs", "created_by": "Cosmic_Penguin", "created_on": "2022-10-12T00:28:23Z" }, { "id": 2561, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch rescheduled to October 12", "info_url": "https://twitter.com/JAXA_jp/status/1578979265496113152", "created_by": "Cosmic_Penguin", "created_on": "2022-10-09T06:33:29Z" }, { "id": 2529, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch delayed due to unspecified problem with the launch vehicle; new date TBD", "info_url": "https://www.jaxa.jp/press/2022/10/20221005-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2022-10-05T04:33:20Z" }, { "id": 2196, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch date and time", "info_url": "https://www.jaxa.jp/press/2022/08/20220808-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2022-08-08T03:26:18Z" }, { "id": 1848, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch under preparations right now", "info_url": "https://www.kenkai.jaxa.jp/kakushin/kakushin03.html", "created_by": "Cosmic_Penguin", "created_on": "2022-06-11T18:30:36Z" } ], "net": "2022-10-12T00:50:43Z", "net_precision": null, "window_end": "2022-10-12T00:55:11Z", "window_start": "2022-10-12T00:50:43Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Flight Termination System activated at T+06:28 after rocket was observed not in correct attitude for normal 2nd/3rd stage separation.", "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": 377, "configuration": { "id": 112, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/112/?format=api", "name": "Epsilon", "active": true, "reusable": false, "description": "The Epsilon rocket is a Japanese solid-fuel rocket designed to launch scientific satellites. It is a follow-on project to the larger and more expensive M-V rocket which was retired in 2006. The Japan Aerospace Exploration Agency (JAXA) began developing the Epsilon in 2007. It is capable of placing a 590 kg payload into Sun-synchronous orbit.", "family": "Epsilon", "full_name": "Epsilon", "manufacturer": { "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" }, "program": [], "variant": "", "alias": "", "min_stage": 3, "max_stage": 4, "length": 24.4, "diameter": 2.5, "maiden_flight": "2013-09-14", "launch_cost": "39000000", "launch_mass": 91, "leo_capacity": null, "gto_capacity": null, "to_thrust": 2271, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/epsilon_image_20221009075145.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Epsilon_(rocket)", "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 5, "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": 6121, "name": "RAISE-3 & others", "description": "RAISE-3 (RApid Innovative payload demonstration Satellite-3) was a satellite for on-orbit demonstrations of 7 demonstration components and equipment selected by public solicitation. The satellite was to be operated in response to requests from the demonstration theme proposers, and will provide experimental data of the demonstration devices and environmental data during the experiments.\r\n\r\nThe launch is also carrying QPS-SAR 3 & 4 radar Earth observation satellites for iQPS, and 5 cubesats for various Japanese institutions & companies.", "launch_designator": null, "type": "Technology", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 47, "url": "https://ll.thespacedevs.com/2.2.0/pad/47/?format=api", "agency_id": 37, "name": "Mu Center", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Uchinoura_Space_Center", "map_url": "https://www.google.com/maps?q=31.2509794,131.0821319", "latitude": "31.2509794", "longitude": "131.0821319", "location": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/location/24/?format=api", "name": "Uchinoura Space Center, Japan", "country_code": "JPN", "description": "The Uchinoura Space Center is a space launch facility in the Japanese town of Kimotsuki, Kagoshima Prefecture. All of Japan's scientific satellites were launched from Uchinoura prior to the M-V launch vehicles being decommissioned in 2006. It continues to be used for suborbital launches, stratospheric balloons and has also been used for the Epsilon orbital launch vehicle. Additionally, the center has antennas for communication with interplanetary space probes.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_24_20200803142411.jpg", "timezone_name": "Asia/Tokyo", "total_launch_count": 43, "total_landing_count": 0 }, "country_code": "JPN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_47_20200803143524.jpg", "total_launch_count": 36, "orbital_launch_attempt_count": 36 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/epsilon_image_20221009075145.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6317, "location_launch_attempt_count": 43, "pad_launch_attempt_count": 36, "agency_launch_attempt_count": 35, "orbital_launch_attempt_count_year": 135, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P336DT23H55M27S", "mission_patches": [ { "id": 655, "name": "RAISE-3 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/raise-32520pat_mission_patch_20221009074916.png", "agency": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" } } ], "type": "detailed" }
