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/f49d890e-09a1-4627-91fd-ac4884a5bd51/?format=api
{ "id": "f49d890e-09a1-4627-91fd-ac4884a5bd51", "url": "https://ll.thespacedevs.com/2.3.0/launches/f49d890e-09a1-4627-91fd-ac4884a5bd51/?format=api", "name": "Volna | Cosmos-1", "response_mode": "detailed", "slug": "volna-cosmos-1", "launch_designator": null, "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-06-14T04:25:23Z", "net": "2005-06-21T19:46:09Z", "net_precision": null, "window_end": "2005-06-21T19:46:09Z", "window_start": "2005-06-21T19:46:09Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1013, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1013/?format=api", "name": "Makeyev Rocket Design Bureau", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": "The JSC Makeyev Design Bureau is a Russian missile design company located in Miass, Russia.\r\n\r\nEstablished in December 1947 as SKB-385, the company is the main designer of submarine-launched ballistic missiles (SLBM) in Russia. The organization was named in honor of Victor Makeyev. Its full official name is State Rocket Center «Academician V.P. Makeev Design Bureau».\r\n\r\nIn 1965, SKB-385 was redesignated the Design Bureau of Machine-Building (KBM) under the Ministry of General Machine-Building.", "administrator": null, "founding_year": 1947, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 3, "consecutive_successful_launches": 1, "successful_launches": 2, "failed_launches": 1, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Makeyev_Rocket_Design_Bureau", "social_media_links": [] }, "rocket": { "id": 7230, "configuration": { "response_mode": "detailed", "id": 450, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/450/?format=api", "name": "Volna", "families": [], "full_name": "Volna", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1013, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1013/?format=api", "name": "Makeyev Rocket Design Bureau", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": "The JSC Makeyev Design Bureau is a Russian missile design company located in Miass, Russia.\r\n\r\nEstablished in December 1947 as SKB-385, the company is the main designer of submarine-launched ballistic missiles (SLBM) in Russia. The organization was named in honor of Victor Makeyev. Its full official name is State Rocket Center «Academician V.P. Makeev Design Bureau».\r\n\r\nIn 1965, SKB-385 was redesignated the Design Bureau of Machine-Building (KBM) under the Ministry of General Machine-Building.", "administrator": null, "founding_year": 1947, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 3, "consecutive_successful_launches": 1, "successful_launches": 2, "failed_launches": 1, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Makeyev_Rocket_Design_Bureau", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Volna", "description": "Space launch vehicle Volna is a converted Submarine-launched ballistic missile used for launching satellites into orbit. It is based on the R-29R designed by State Rocket Center Makayev and related to the Shtil' Launch Vehicle . The Volna is a 3-stage launch vehicle that uses liquid propellant. The warhead section is used for the payloads that can be either put into orbit with the help of an additional boost engine or travel along a sub-orbital trajectory to be recovered at the landing site. Volna can be launched from Delta III-class submarine or from land based facilities.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 14.1, "diameter": 1.9, "maiden_flight": "1975-01-01", "launch_cost": null, "launch_mass": 35.0, "leo_capacity": 120.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 682.0, "apogee": null, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5619, "name": "Cosmos-1", "type": "Earth Science", "description": "Cosmos 1 was a project by Cosmos Studios and The Planetary Society to test a solar sail in space. As part of the project, an unmanned solar-sail spacecraft named Cosmos 1 was launched into space at 15:46:09 EDT (19:46:09 UTC) on June 21, 2005 from the submarine Borisoglebsk in the Barents Sea. However, a rocket failure prevented the spacecraft from reaching its intended orbit.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 148, "url": "https://ll.thespacedevs.com/2.3.0/pads/148/?format=api", "active": true, "agencies": [], "name": "Borisoglebsk (K-496)", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_submarine_Borisoglebsk_(K-496)", "map_url": "https://www.google.com/maps?q=74.0000,38.0000", "latitude": 74.0, "longitude": 38.0, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_148_20200803143426.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 3, "url": "https://ll.thespacedevs.com/2.3.0/locations/3/?format=api", "name": "Sea Launch", "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": 7149, "successful_launches": 6606, "failed_launches": 543, "total_attempted_landings": 1103, "successful_landings": 1060, "failed_landings": 43 }, "active": true, "country": { "id": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 1418, "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192712.jpeg", "credit": "CASC", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 55, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4718, "location_launch_attempt_count": 18, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 24, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
