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/bc321d24-1c15-47e1-a966-497f1ca9dff2/?format=api
{ "id": "bc321d24-1c15-47e1-a966-497f1ca9dff2", "url": "https://ll.thespacedevs.com/2.2.0/launch/bc321d24-1c15-47e1-a966-497f1ca9dff2/?format=api", "slug": "epsilon-raise-2-others", "flightclub_url": null, "r_spacex_api_id": null, "name": "Epsilon | RAISE-2 & others", "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-08-16T06:37:21Z", "updates": [ { "id": 954, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch success confirmed per webcast", "info_url": null, "created_by": "SwGustav", "created_on": "2021-11-09T02:27:42Z" }, { "id": 953, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": null, "created_by": "SwGustav", "created_on": "2021-11-09T00:56:02Z" }, { "id": 950, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date and time.", "info_url": "https://twitter.com/jaxa_jp/status/1456894319407742983?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-11-06T08:36:27Z" }, { "id": 941, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch delayed due to weather, no new date announced yet.", "info_url": "https://www.jaxa.jp/press/2021/11/20211105-2_j.html", "created_by": "Cosmic_Penguin", "created_on": "2021-11-05T06:36:16Z" }, { "id": 919, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Confirmation of new launch window", "info_url": "https://twitter.com/jaxa_jp/status/1453592639408787461?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-10-28T07:00:35Z" }, { "id": 916, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date.", "info_url": "https://www3.nhk.or.jp/lnews/kagoshima/20211027/5050016695.html", "created_by": "Cosmic_Penguin", "created_on": "2021-10-27T13:02:09Z" }, { "id": 851, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date and time.", "info_url": "https://www.jaxa.jp/press/2021/10/20211004-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2021-10-04T08:39:15Z" }, { "id": 848, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/scorp_profile_20210217185945.jpg", "comment": "Pushing by a couple days. No info yet.", "info_url": null, "created_by": "JRascagneres", "created_on": "2021-10-03T00:50:11Z" }, { "id": 844, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch aborted at T-19 seconds. Reverting back to TBD until a new launch window is announced.", "info_url": "https://www.jaxa.jp/press/2021/10/20211001-2_j.html", "created_by": "Nosu", "created_on": "2021-10-01T04:15:53Z" }, { "id": 842, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Refined launch window.", "info_url": "https://www.jaxa.jp/press/2021/09/20210929-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2021-09-29T07:32:01Z" }, { "id": 730, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://www.jaxa.jp/press/2021/08/20210820-2_j.html", "created_by": "Cosmic_Penguin", "created_on": "2021-08-20T07:06:41Z" }, { "id": 856, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Scrubbed due to winds.", "info_url": null, "created_by": "SwGustav", "created_on": "2021-10-07T00:38:47Z" }, { "id": 859, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "New launch date will be determined after the Oct 25 launch of H-IIA. Putting to a placeholder end of month date for now.", "info_url": "https://www.jaxa.jp/press/2021/10/20211008-1_j.html", "created_by": "spacevogel", "created_on": "2021-10-08T09:00:26Z" } ], "net": "2021-11-09T00:55:16Z", "net_precision": null, "window_end": "2021-11-09T00:59:00Z", "window_start": "2021-11-09T00:48:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "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": 3000, "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": 1426, "name": "RAISE-2 & others", "description": "8 payloads will fly on this mission : \"RApid Innovative payload demonstration SatellitE-2\" (RAISE-2), DRUMS (Debris Removal Unprecedented Micro-Satellite), Hibari, Z-Sat, and four CubeSat (ASTERISC, ARICA, NANODRAGON, KOSEN-1).", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "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": [ { "priority": 8, "source": "youtube.com", "publisher": "JAXA | 宇宙航空研究開発機構", "title": "革新的衛星技術実証２号機／イプシロンロケット５号機打上げライブ中継・LIVE: Launch of the Epsilon-5 with Innovative Satellites 2 onboard", "description": "2021年11月9日9時55分、イプシロンロケット5号機による革新的衛星技術実証2号機の打上げの様子を9時15分頃からライブ配信します。\nPlease join us for the live coverage of the launch of the Epsilon-5 with Innovative Satellites 2 onboard. The live stream will star...", "feature_image": "https://i.ytimg.com/vi/WtF378ZFyzM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=WtF378ZFyzM", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2021-11-08T23:45:13Z", "end_time": "2021-11-09T02:16:54Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/epsilon_image_20221009075145.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6147, "location_launch_attempt_count": 42, "pad_launch_attempt_count": 35, "agency_launch_attempt_count": 34, "orbital_launch_attempt_count_year": 110, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1026DT4M56S", "mission_patches": [], "type": "detailed" }
