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/bb1c35a3-5a33-40e1-888e-d292e652c178/?format=api
{ "id": "bb1c35a3-5a33-40e1-888e-d292e652c178", "url": "https://ll.thespacedevs.com/2.2.0/launch/bb1c35a3-5a33-40e1-888e-d292e652c178/?format=api", "slug": "ariane-42l-pas-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 42L | PAS 4", "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:21Z", "updates": [], "net": "1995-08-03T22:58:00Z", "net_precision": null, "window_end": "1995-08-03T22:58:00Z", "window_start": "1995-08-03T22:58:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "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": "", "launch_library_url": null, "total_launch_count": 319, "consecutive_successful_launches": 7, "successful_launches": 304, "failed_launches": 15, "pending_launches": 48, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.arianespace.com", "wiki_url": "http://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 6674, "configuration": { "id": 223, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/223/?format=api", "name": "Ariane 42L", "active": false, "reusable": false, "description": "The Ariane 4 was an expendable space launch system, developed by the Centre national d'études spatiales (CNES), the French space agency, for the European Space Agency (ESA). It was manufactured by ArianeGroup and marketed by Arianespace. Since its first flight on 15 June 1988 until the final flight on 15 February 2003, it attained 113 successful launches out of 116 total launches.", "family": "Ariane", "full_name": "Ariane 42L", "manufacturer": { "id": 1003, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1003/?format=api", "name": "Aérospatiale", "featured": false, "type": "Government", "country_code": "FRA", "abbrev": "", "description": "Aérospatiale was a French state-owned aerospace manufacturer that built both civilian and military aircraft, rockets and satellites. It was originally known as Société nationale industrielle aérospatiale (SNIAS). Its head office was in the 16th arrondissement of Paris. The name was changed to Aérospatiale during 1970.", "administrator": null, "founding_year": "1970", "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/A%C3%A9rospatiale", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "42L", "alias": "", "min_stage": 2, "max_stage": 2, "length": 55.6, "diameter": 3.8, "maiden_flight": "1993-03-12", "launch_cost": null, "launch_mass": 367, "leo_capacity": 7000, "gto_capacity": 3590, "to_thrust": 4600, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_42l_at_e_image_20240401083718.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_4", "total_launch_count": 13, "consecutive_successful_launches": 13, "successful_launches": 13, "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": 5064, "name": "PAS 4", "description": "In November 1991, PanAmSat Corporation ordered three Hughes HS-601 model PAS (PanAmSat) satellites from Hughes Space and Communications Company. The satellites provide video services for program distribution and syndication; data services for business applications; and services for video, radio, data and telephone transmission. They were placed over the Pacific, Atlantic and Indian oceans, respectively. In August 1993, PanAmSat ordered a fourth satellite, to be used as a spare. The spare was pressed into service to replace the first PAS-3 spacecraft, which was lost during a launch vehicle failure.", "launch_designator": null, "type": "Communications", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/pad/124/?format=api", "agency_id": 115, "name": "Ariane Launch Area 2", "description": "The ELA-2 pad, built in 1986, had been used for Ariane 4 launches from 1988 until 2003. Before 1988, although purpose-built for Ariane 4, the pad hosted an Ariane-2 and two Ariane-3 launches.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-2", "map_url": "https://www.google.com/maps?q=5.232,-52.778194", "latitude": "5.232", "longitude": "-52.778194", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "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.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 325, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_124_20200803143241.jpg", "total_launch_count": 119, "orbital_launch_attempt_count": 119 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_42l_at_e_image_20240401083718.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 4005, "location_launch_attempt_count": 85, "pad_launch_attempt_count": 51, "agency_launch_attempt_count": 75, "orbital_launch_attempt_count_year": 44, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 6, "pad_turnaround": "P27DT6H34M26S", "mission_patches": [], "type": "detailed" }
