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__agency__ids, 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 - lldev.thespacedevs.com/docs
GET /2.3.0/launches/d6cc6817-411a-4802-9a29-1f43e7011ba8/?format=api
{ "id": "d6cc6817-411a-4802-9a29-1f43e7011ba8", "url": "https://lldev.thespacedevs.com/2.3.0/launches/d6cc6817-411a-4802-9a29-1f43e7011ba8/?format=api", "name": "Diamant B | Tournesol", "response_mode": "detailed", "slug": "diamant-b-tournesol", "launch_designator": "1971-030", "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": "1971-04-15T09:19:37Z", "net_precision": null, "window_end": "1971-04-15T09:19:37Z", "window_start": "1971-04-15T09:19:37Z", "image": { "id": 2073, "name": "Diamant B liftoff (Péole)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/diamant_b_lifto_image_20240411170212.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/diamant_b_lifto_image_thumbnail_20240411170212.jpeg", "credit": "CNES", "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://lldev.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": "CEO: François Jacq", "founding_year": 1961, "launchers": "Ariane 5", "spacecraft": "Mars/Venus Express | Rosetta", "parent": null, "image": { "id": 2425, "name": "CNES Toulouse entrance", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_20250722090314.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_thumbnail_20250722090314.jpeg", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [] }, "logo": { "id": 2426, "name": "CNES logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_20250722090832.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_thumbnail_20250722090832.png", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [ { "id": 17, "type": { "id": 1, "name": "transparent for light background" }, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/image_variants/logo_cnes_2017__image_20250722090832.png" }, { "id": 18, "type": { "id": 2, "name": "transparent for dark background" }, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/image_variants/logo_cnes_2017__image_20250722090832.png" } ] }, "social_logo": { "id": 2427, "name": "CNES social logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_20250722090952.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_thumbnail_20250722090953.jpeg", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [] }, "total_launch_count": 14, "consecutive_successful_launches": 3, "successful_launches": 12, "failed_launches": 2, "pending_launches": 1, "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.cnes.fr/", "wiki_url": "https://en.wikipedia.org/wiki/CNES", "social_media_links": [] }, "rocket": { "id": 4122, "configuration": { "response_mode": "detailed", "id": 312, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/312/?format=api", "name": "Diamant B", "families": [ { "response_mode": "detailed", "id": 74, "name": "Diamant", "manufacturer": [ { "response_mode": "normal", "id": 1008, "url": "https://lldev.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 B", "variant": "B", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1008, "url": "https://lldev.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": 2073, "name": "Diamant B liftoff (Péole)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/diamant_b_lifto_image_20240411170212.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/diamant_b_lifto_image_thumbnail_20240411170212.jpeg", "credit": "CNES", "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": 23.5, "diameter": 1.34, "maiden_flight": "1970-03-10", "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": 5, "consecutive_successful_launches": 0, "successful_launches": 3, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P123DT20H14M53S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 2540, "name": "Tournesol", "type": "Astrophysics", "description": "French satellite designed to detect the presence of hydrogen in several directions of the celestial sphere.", "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://lldev.thespacedevs.com/2.3.0/pads/125/?format=api", "active": false, "agencies": [ { "response_mode": "normal", "id": 46, "url": "https://lldev.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": "CEO: François Jacq", "founding_year": 1961, "launchers": "Ariane 5", "spacecraft": "Mars/Venus Express | Rosetta", "parent": null, "image": { "id": 2425, "name": "CNES Toulouse entrance", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_20250722090314.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_thumbnail_20250722090314.jpeg", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [] }, "logo": { "id": 2426, "name": "CNES logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_20250722090832.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_thumbnail_20250722090832.png", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [ { "id": 17, "type": { "id": 1, "name": "transparent for light background" }, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/image_variants/logo_cnes_2017__image_20250722090832.png" }, { "id": 18, "type": { "id": 2, "name": "transparent for dark background" }, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/image_variants/logo_cnes_2017__image_20250722090832.png" } ] }, "social_logo": { "id": 2427, "name": "CNES social logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_20250722090952.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_thumbnail_20250722090953.jpeg", "credit": "CNES", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": true, "variants": [] } } ], "name": "Diamant Launch Area", "image": { "id": 2477, "name": "ELM Diamant render", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/elm_diamant_ren_image_20250916111400.webp", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/elm_diamant_ren_image_thumbnail_20250916111400.jpeg", "credit": "CNES/L'Œil du Chat", "license": { "id": 26, "name": "CNES Image Use Policy", "priority": 2, "link": "https://phototheque.cnes.fr/cnes/info2.do" }, "single_use": false, "variants": [] }, "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-dev.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://lldev.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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.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": 7499, "successful_launches": 6943, "failed_launches": 556, "total_attempted_landings": 1303, "successful_landings": 1256, "failed_landings": 47 }, "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-dev.nyc3.digitaloceanspaces.com/media/images/vega_2526_aria_image_20240918154413.jpg", "thumbnail_url": "https://thespacedevs-dev.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-dev.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "longitude": -52.6903, "latitude": 5.169, "timezone_name": "America/Cayenne", "total_launch_count": 332, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 1205, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 34, "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": "P123DT20H14M53S", "mission_patches": [] }
