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/17e09ced-9767-4eee-a071-e7900a5ad5db/?format=api
{ "id": "17e09ced-9767-4eee-a071-e7900a5ad5db", "url": "https://ll.thespacedevs.com/2.3.0/launches/17e09ced-9767-4eee-a071-e7900a5ad5db/?format=api", "name": "H-II | Kakehashi", "response_mode": "detailed", "slug": "h-ii-kakehashi", "launch_designator": "1998-011", "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:06Z", "net": "1998-02-21T07:55:00Z", "net_precision": null, "window_end": "1998-02-21T07:55:00Z", "window_start": "1998-02-21T07:55:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 37, "url": "https://ll.thespacedevs.com/2.3.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "abbrev": "JAXA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "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": "", "parent": null, "image": { "id": 16, "name": "[AUTO] Japan Aerospace Exploration Agency - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184621.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 151, "name": "[AUTO] Japan Aerospace Exploration Agency - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185023.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 69, "name": "[AUTO] Japan Aerospace Exploration Agency - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184813.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 36, "consecutive_successful_launches": 1, "successful_launches": 32, "failed_launches": 4, "pending_launches": 4, "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": 1, "failed_landings_payload": 0, "attempted_landings_payload": 1, "info_url": "http://www.jaxa.jp/", "wiki_url": "http://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency", "social_media_links": [] }, "rocket": { "id": 6841, "configuration": { "response_mode": "detailed", "id": 320, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/320/?format=api", "name": "H-II", "families": [ { "response_mode": "detailed", "id": 88, "name": "H-II", "manufacturer": [ { "response_mode": "normal", "id": 98, "url": "https://ll.thespacedevs.com/2.3.0/agencies/98/?format=api", "name": "Mitsubishi Heavy Industries", "abbrev": "MHI", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "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", "parent": null, "image": { "id": 18, "name": "[AUTO] Mitsubishi Heavy Industries - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184626.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 160, "name": "[AUTO] Mitsubishi Heavy Industries - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185040.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 75, "name": "[AUTO] Mitsubishi Heavy Industries - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184821.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 54, "consecutive_successful_launches": 6, "successful_launches": 53, "failed_launches": 1, "pending_launches": 13, "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": "https://www.mhi.com/", "wiki_url": "http://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1994-02-03", "total_launch_count": 65, "consecutive_successful_launches": 52, "successful_launches": 63, "failed_launches": 2, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "H-II", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 98, "url": "https://ll.thespacedevs.com/2.3.0/agencies/98/?format=api", "name": "Mitsubishi Heavy Industries", "abbrev": "MHI", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "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", "parent": null, "image": { "id": 18, "name": "[AUTO] Mitsubishi Heavy Industries - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184626.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 160, "name": "[AUTO] Mitsubishi Heavy Industries - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185040.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 75, "name": "[AUTO] Mitsubishi Heavy Industries - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184821.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 54, "consecutive_successful_launches": 6, "successful_launches": 53, "failed_launches": 1, "pending_launches": 13, "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": "https://www.mhi.com/", "wiki_url": "http://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/H-II", "description": "The H-II rocket was a Japanese satellite launch system which flew seven times between 1994 and 1999 with 5 successes. It was developed by NASDA in order to give Japan a capability to launch larger satellites in the 1990s. It was the first two stage liquid fuelled rocket Japan made using only domestic technologies.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 49.0, "diameter": 4.0, "maiden_flight": "1994-02-03", "launch_cost": null, "launch_mass": 260.0, "leo_capacity": 10060.0, "gto_capacity": 3930.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 7, "consecutive_successful_launches": 0, "successful_launches": 6, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P85DT10H28M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5231, "name": "Kakehashi", "type": "Communications", "description": "COMETS (Communication Engineering Test Satellite) a two-ton geostationary three-axis stabilized satellite, is being created to develop the new technologies required for future fields in communications and broadcasting.", "image": null, "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 41, "url": "https://ll.thespacedevs.com/2.3.0/pads/41/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 37, "url": "https://ll.thespacedevs.com/2.3.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "abbrev": "JAXA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "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": "", "parent": null, "image": { "id": 16, "name": "[AUTO] Japan Aerospace Exploration Agency - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184621.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 151, "name": "[AUTO] Japan Aerospace Exploration Agency - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185023.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 69, "name": "[AUTO] Japan Aerospace Exploration Agency - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184813.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Yoshinobu Launch Complex LP-1", "image": { "id": 1520, "name": "H-IIA 202 liftoff from LP-1 (IGS Radar 7)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia25202022_image_20240101101918.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193026.jpeg", "credit": "Mitsubishi Heavy Industries", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "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, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg", "total_launch_count": 56, "orbital_launch_attempt_count": 56, "fastest_turnaround": "P25DT4H54M", "location": { "response_mode": "normal", "id": 26, "url": "https://ll.thespacedevs.com/2.3.0/locations/26/?format=api", "name": "Tanegashima Space Center, Japan", "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": 7158, "successful_launches": 6615, "failed_launches": 543, "total_attempted_landings": 1109, "successful_landings": 1066, "failed_landings": 43 }, "active": true, "country": { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" }, "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.", "image": { "id": 2223, "name": "Tanegashima Space Center", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tanegashima_spa_image_20240920081514.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tanegashima_spa_image_thumbnail_20240920081514.jpeg", "credit": "JAXA", "license": { "id": 9, "name": "JAXA Image Usage Policy", "priority": 8, "link": "https://global.jaxa.jp/policy.html" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg", "longitude": 130.97, "latitude": 30.4, "timezone_name": "Asia/Tokyo", "total_launch_count": 94, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4219, "location_launch_attempt_count": 30, "pad_launch_attempt_count": 6, "agency_launch_attempt_count": 6, "orbital_launch_attempt_count_year": 12, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P85DT10H28M", "mission_patches": [] }
