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/e7434c5e-3660-4135-9f91-46b1bfbd01fc/?format=api
{ "id": "e7434c5e-3660-4135-9f91-46b1bfbd01fc", "url": "https://ll.thespacedevs.com/2.3.0/launches/e7434c5e-3660-4135-9f91-46b1bfbd01fc/?format=api", "name": "Diamant A | Asterix", "response_mode": "detailed", "slug": "diamant-a-asterix", "launch_designator": "1965-096", "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-14T04:25:02Z", "net": "1965-11-26T14:47:21Z", "net_precision": null, "window_end": "1965-11-26T14:47:21Z", "window_start": "1965-11-26T14:47:21Z", "image": { "id": 2074, "name": "Diamant A liftoff (Astérix)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_20240411170731.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_thumbnail_20240411170731.png", "credit": "ESA", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 46, "url": "https://ll.thespacedevs.com/2.3.0/agencies/46/?format=api", "name": "National Center of Space Research", "abbrev": "CNES", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" } ], "description": "The National Center of Space Research, or CNES, is a French National Agency in charge of France's space program. In partnership with the US and Russia, they have put 10 people in space. CNES works in tandem with the larger ESA to develop the Ariane 5 and work on other probes and satellites. They are working with Germany to develop a cheaper and more efficient reusable rocket, which hopefully will be ready to fly by 2026.", "administrator": "Interim CEO: Lionel Suchet", "founding_year": 1961, "launchers": "Ariane 5", "spacecraft": "Mars/Venus Express | Rosetta", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 14, "consecutive_successful_launches": 3, "successful_launches": 12, "failed_launches": 2, "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": "http://www.cnes.fr/", "wiki_url": "http://en.wikipedia.org/wiki/CNES", "social_media_links": [] }, "rocket": { "id": 3460, "configuration": { "response_mode": "detailed", "id": 311, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/311/?format=api", "name": "Diamant A", "families": [ { "response_mode": "detailed", "id": 74, "name": "Diamant", "manufacturer": [ { "response_mode": "normal", "id": 1008, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1008/?format=api", "name": "Société d'étude et de réalisation d'engins balistiques", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" } ], "description": "Société d'étude et de réalisation d'engins balistiques or SÉREB was a French aviation company. It was created initially to develop two-stage ballistic missiles for nuclear weapons (Force de dissuasion nucléaire française). CNES was formed in 1961, which took over much development of civilian research.", "administrator": null, "founding_year": 1959, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "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/Soci%C3%A9t%C3%A9_d%27%C3%A9tude_et_de_r%C3%A9alisation_d%27engins_balistiques", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1965-11-26", "total_launch_count": 12, "consecutive_successful_launches": 3, "successful_launches": 10, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Diamant A", "variant": "A", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1008, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1008/?format=api", "name": "Société d'étude et de réalisation d'engins balistiques", "abbrev": "", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" } ], "description": "Société d'étude et de réalisation d'engins balistiques or SÉREB was a French aviation company. It was created initially to develop two-stage ballistic missiles for nuclear weapons (Force de dissuasion nucléaire française). CNES was formed in 1961, which took over much development of civilian research.", "administrator": null, "founding_year": 1959, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "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/Soci%C3%A9t%C3%A9_d%27%C3%A9tude_et_de_r%C3%A9alisation_d%27engins_balistiques", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 2074, "name": "Diamant A liftoff (Astérix)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_20240411170731.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_thumbnail_20240411170731.png", "credit": "ESA", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Diamant", "description": "The Diamant rocket (Diamant is French for \"diamond\") was the first exclusively French expendable launch system and at the same time the first satellite launcher not built by either the United States or USSR. As such, it has been referred to as being a key predecessor for all subsequent European launcher projects.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 18.95, "diameter": 1.34, "maiden_flight": "1965-11-26", "launch_cost": null, "launch_mass": 18.0, "leo_capacity": 160.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 301.0, "apogee": null, "total_launch_count": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P7DT27M18S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1880, "name": "Asterix", "type": "Test Flight", "description": "First french satellite", "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": 141, "url": "https://ll.thespacedevs.com/2.3.0/pads/141/?format=api", "active": true, "agencies": [], "name": "Brigitte", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Hammaguir", "map_url": "https://www.google.com/maps?q=30.7787318,-3.0669721", "latitude": 30.7787318, "longitude": -3.0669721, "country": { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_141_20200803143211.jpg", "total_launch_count": 4, "orbital_launch_attempt_count": 4, "fastest_turnaround": "P7DT27M18S", "location": { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/locations/147/?format=api", "name": "Interarmy Special Vehicles Test Centre, French Algeria", "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": 7156, "successful_launches": 6613, "failed_launches": 543, "total_attempted_landings": 1108, "successful_landings": 1065, "failed_landings": 43 }, "active": false, "country": { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" }, "description": "The Centre Interarmées d'Essais d'Engins Spéciaux was France's first space launch and ballistic missile testing facility. Outside France, the facility is often referred to by the name of the nearest town, Hammaguir. It was established on 24 April 1947, by ministerial decree as the Special Weapons Test Center (CEES, Centre d'essais d'engins spéciaux) for use by the French Army. In 1948, it was turned over to the French Air Force, who renamed it CIEES. Its remote location in the middle of the Saharan Desert and its relative closeness to the Equator (compared with Metropolitan France) made it an attractive launch site for missiles and orbital rockets.", "image": { "id": 2135, "name": "Diamant on the Hammaguir pad", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_on_the__image_20240808091939.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_on_the__image_thumbnail_20240808091941.jpeg", "credit": "SIRPA-ECPA", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_147_20240808092142.jpg", "longitude": -3.055278, "latitude": 30.778056, "timezone_name": "Africa/Algiers", "total_launch_count": 4, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 500, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 107, "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": "P0D", "mission_patches": [] }
