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/09d5a8f8-225b-4b2d-93bb-5203bc47d092/?format=api
{ "id": "09d5a8f8-225b-4b2d-93bb-5203bc47d092", "url": "https://ll.thespacedevs.com/2.3.0/launches/09d5a8f8-225b-4b2d-93bb-5203bc47d092/?format=api", "name": "Mu-3S-II | Akebono", "response_mode": "detailed", "slug": "mu-3s-ii-akebono", "launch_designator": "1989-016", "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:59Z", "net": "1989-02-21T23:30:00Z", "net_precision": null, "window_end": "1989-02-21T23:30:00Z", "window_start": "1989-02-21T23:30:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1009, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1009/?format=api", "name": "Institute of Space and Astronautical Science", "abbrev": "ISAS", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.", "administrator": null, "founding_year": null, "launchers": "Lambda", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 32, "consecutive_successful_launches": 1, "successful_launches": 24, "failed_launches": 8, "pending_launches": 0, "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://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "wiki_url": "https://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "social_media_links": [] }, "rocket": { "id": 6154, "configuration": { "response_mode": "detailed", "id": 339, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/339/?format=api", "name": "Mu-3S-II", "families": [ { "response_mode": "detailed", "id": 124, "name": "Mu", "manufacturer": [ { "response_mode": "normal", "id": 1009, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1009/?format=api", "name": "Institute of Space and Astronautical Science", "abbrev": "ISAS", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.", "administrator": null, "founding_year": null, "launchers": "Lambda", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 32, "consecutive_successful_launches": 1, "successful_launches": 24, "failed_launches": 8, "pending_launches": 0, "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://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "wiki_url": "https://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1970-09-25", "total_launch_count": 30, "consecutive_successful_launches": 4, "successful_launches": 26, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Mu-3S-II", "variant": "S-II", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1009, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1009/?format=api", "name": "Institute of Space and Astronautical Science", "abbrev": "ISAS", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 28, "name": "Japan", "alpha_2_code": "JP", "alpha_3_code": "JPN", "nationality_name": "Japanese", "nationality_name_composed": "Nippo" } ], "description": "ISAS is a Japanese national research organization of astrophysics using rockets, astronomical satellites and interplanetary probes which played a major role in Japan's space development.", "administrator": null, "founding_year": null, "launchers": "Lambda", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 32, "consecutive_successful_launches": 1, "successful_launches": 24, "failed_launches": 8, "pending_launches": 0, "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://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "wiki_url": "https://en.wikipedia.org/wiki/Institute_of_Space_and_Astronautical_Science", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Mu_(rocket_family)", "description": "The Mu, also known as M, was a series of Japanese solid-fuelled carrier rockets, which were launched from Uchinoura between 1966 and 2006. Originally developed by Japan's Institute of Space and Astronautical Science, Mu rockets were later operated by Japan Aerospace Exploration Agency following ISAS becoming part of it.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 27.8, "diameter": 1.41, "maiden_flight": "1985-01-07", "launch_cost": null, "launch_mass": 61.0, "leo_capacity": 800.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 1930.0, "apogee": null, "total_launch_count": 8, "consecutive_successful_launches": 0, "successful_launches": 7, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P223DT4H7M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 4544, "name": "Akebono", "type": "Earth Science", "description": "Japanese upper atmosphere research satellite", "image": null, "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 47, "url": "https://ll.thespacedevs.com/2.3.0/pads/47/?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": "Mu Center", "image": null, "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, "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_47_20200803143524.jpg", "total_launch_count": 36, "orbital_launch_attempt_count": 36, "fastest_turnaround": "P143DT23H", "location": { "response_mode": "normal", "id": 24, "url": "https://ll.thespacedevs.com/2.3.0/locations/24/?format=api", "name": "Uchinoura 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": 7148, "successful_launches": 6605, "failed_launches": 543, "total_attempted_landings": 1102, "successful_landings": 1059, "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 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.", "image": { "id": 2225, "name": "Uchinoura Space Center, Japan", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_20240920082429.JPG", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/uchinoura_space_image_thumbnail_20240920082429.jpeg", "credit": "Ippukucho", "license": { "id": 19, "name": "CC BY 3.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/3.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_24_20200803142411.jpg", "longitude": 131.081944, "latitude": 31.251944, "timezone_name": "Asia/Tokyo", "total_launch_count": 43, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 3390, "location_launch_attempt_count": 24, "pad_launch_attempt_count": 19, "agency_launch_attempt_count": 24, "orbital_launch_attempt_count_year": 16, "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": "P747DT17H", "mission_patches": [] }
