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/0c9d8810-8a3a-4e75-93cf-a33d50b1afce/?format=api
{ "id": "0c9d8810-8a3a-4e75-93cf-a33d50b1afce", "url": "https://ll.thespacedevs.com/2.3.0/launches/0c9d8810-8a3a-4e75-93cf-a33d50b1afce/?format=api", "name": "Diamant BP4 | Aura", "response_mode": "detailed", "slug": "diamant-bp4-aura", "launch_designator": "1975-092", "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:22:27Z", "net": "1975-09-27T08:37:00Z", "net_precision": null, "window_end": "1975-09-27T08:37:00Z", "window_start": "1975-09-27T08:37:00Z", "image": null, "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": 4629, "configuration": { "response_mode": "detailed", "id": 313, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/313/?format=api", "name": "Diamant BP4", "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 BP4", "variant": "BP4", "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": null, "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": 21.6, "diameter": 1.34, "maiden_flight": "1975-02-06", "launch_cost": null, "launch_mass": 18.0, "leo_capacity": 160.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 396.0, "apogee": null, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P99DT17H57M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 3047, "name": "Aura", "type": "Earth Science", "description": "French scientific satellite dedicated to solar and atmospheric investigations", "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": 125, "url": "https://ll.thespacedevs.com/2.3.0/pads/125/?format=api", "active": false, "agencies": [ { "response_mode": "normal", "id": 115, "url": "https://ll.thespacedevs.com/2.3.0/agencies/115/?format=api", "name": "Arianespace", "abbrev": "ASA", "type": { "id": 3, "name": "Commercial" }, "featured": true, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" } ], "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": 1980, "launchers": "Ariane | Vega", "spacecraft": "", "parent": "ArianeGroup", "image": { "id": 1692, "name": "Ariane 62 on ELA-4 (Maiden Flight)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_thumbnail_20240708201808.jpeg", "credit": "ESA/L. Bourgeon", "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": false, "variants": [] }, "logo": { "id": 108, "name": "Arianespace blue logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184909.png", "credit": "Arianespace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [ { "id": 11, "type": { "id": 1, "name": "transparent for light background" }, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianespace_log_image_20250211184850.png" }, { "id": 12, "type": { "id": 2, "name": "transparent for dark background" }, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianespace_log_image_20250211184853.png" } ] }, "social_logo": { "id": 39, "name": "Arianespace social logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184728.jpeg", "credit": "Arianespace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Diamant Launch Area", "image": null, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=5.2222222,-52.7758051", "latitude": 5.2222222, "longitude": -52.7758051, "country": { "id": 50, "name": "French Guiana", "alpha_2_code": "GF", "alpha_3_code": "GUF", "nationality_name": "French Guianan", "nationality_name_composed": "Franco-Guiano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8, "fastest_turnaround": "P99DT17H57M", "location": { "response_mode": "normal", "id": 13, "url": "https://ll.thespacedevs.com/2.3.0/locations/13/?format=api", "name": "Guiana Space Centre, French Guiana", "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": 50, "name": "French Guiana", "alpha_2_code": "GF", "alpha_3_code": "GUF", "nationality_name": "French Guianan", "nationality_name_composed": "Franco-Guiano" }, "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "image": { "id": 2203, "name": "Vega & Ariane 5 pads at the Guiana Space Centre", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_2526_aria_image_20240918154413.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_2526_aria_image_thumbnail_20240918154414.jpeg", "credit": "ESA/S. Corvaja", "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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "longitude": -52.6903, "latitude": 5.169, "timezone_name": "America/Cayenne", "total_launch_count": 325, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 1747, "location_launch_attempt_count": 9, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 14, "orbital_launch_attempt_count_year": 96, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P132DT22H5M", "mission_patches": [] }
