Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/3795303e-8662-4def-aaec-05144cee34af/?format=api
{ "id": "3795303e-8662-4def-aaec-05144cee34af", "url": "https://ll.thespacedevs.com/2.2.0/launch/3795303e-8662-4def-aaec-05144cee34af/?format=api", "slug": "diamant-a-diapason-d-1a", "flightclub_url": null, "r_spacex_api_id": null, "name": "Diamant A | Diapason D-1A", "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:03Z", "updates": [], "net": "1966-02-17T08:33:36Z", "net_precision": null, "window_end": "1966-02-17T08:33:36Z", "window_start": "1966-02-17T08:33:36Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 46, "url": "https://ll.thespacedevs.com/2.2.0/agencies/46/?format=api", "name": "National Center of Space Research", "featured": false, "type": "Government", "country_code": "FRA", "abbrev": "CNES", "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", "launch_library_url": 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, "info_url": "http://www.cnes.fr/", "wiki_url": "http://en.wikipedia.org/wiki/CNES", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 3492, "configuration": { "id": 311, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/311/?format=api", "name": "Diamant A", "active": false, "reusable": false, "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.", "family": "Diamant", "full_name": "Diamant A", "manufacturer": { "id": 1008, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1008/?format=api", "name": "Société d'étude et de réalisation d'engins balistiques", "featured": false, "type": "Commercial", "country_code": "FRA", "abbrev": "", "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": "", "launch_library_url": 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, "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", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "A", "alias": "", "min_stage": 3, "max_stage": 3, "length": 18.95, "diameter": 1.34, "maiden_flight": "1965-11-26", "launch_cost": null, "launch_mass": 18, "leo_capacity": 160, "gto_capacity": null, "to_thrust": 301, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_20240411170731.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Diamant", "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 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1912, "name": "Diapason D-1A", "description": "Diapason was a small cylindrical satellite, 20 cm long and 50 cm in diameter which was used for making geodetic measurements.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 141, "url": "https://ll.thespacedevs.com/2.2.0/pad/141/?format=api", "agency_id": null, "name": "Brigitte", "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", "location": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/location/147/?format=api", "name": "Interarmy Special Vehicles Test Centre, French Algeria", "country_code": "FRA", "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.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_147_20240808092142.jpg", "timezone_name": "Africa/Algiers", "total_launch_count": 4, "total_landing_count": 0 }, "country_code": "FRA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_141_20200803143211.jpg", "total_launch_count": 4, "orbital_launch_attempt_count": 4 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/diamant_a_lifto_image_20240411170731.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 531, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 14, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P82DT17H46M15S", "mission_patches": [], "type": "detailed" }
