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/4e5142e6-c952-4fe3-81ee-91223789305f/?format=api
{ "id": "4e5142e6-c952-4fe3-81ee-91223789305f", "url": "https://ll.thespacedevs.com/2.2.0/launch/4e5142e6-c952-4fe3-81ee-91223789305f/?format=api", "slug": "ariane-1-ecs-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 1 | ECS 1", "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-14T03:49:39Z", "updates": [], "net": "1983-06-16T11:59:03Z", "net_precision": null, "window_end": "1983-06-16T11:59:03Z", "window_start": "1983-06-16T11:59:03Z", "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": 5530, "configuration": { "id": 219, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/219/?format=api", "name": "Ariane 1", "active": false, "reusable": false, "description": "Ariane 1 was the first rocket in the Ariane family of expendable launch systems. It was developed and operated by the European Space Agency (ESA), which had been formed in 1973, the same year that development of the launch had commenced.", "family": "Ariane", "full_name": "Ariane 1", "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": "1", "alias": "", "min_stage": 4, "max_stage": 4, "length": 50.0, "diameter": 3.8, "maiden_flight": "1979-12-24", "launch_cost": null, "launch_mass": 207, "leo_capacity": 1400, "gto_capacity": 1850, "to_thrust": 2771, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_1_in_fli_image_20240314094301.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_1", "total_launch_count": 11, "consecutive_successful_launches": 6, "successful_launches": 9, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 3934, "name": "ECS 1", "description": "Geostationary communications satellite", "launch_designator": null, "type": "Communications", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "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_34_20200803143527.jpg", "total_launch_count": 52, "orbital_launch_attempt_count": 52 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_1_in_fli_image_20240314094301.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 2705, "location_launch_attempt_count": 15, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 59, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P280DT9H47M3S", "mission_patches": [], "type": "detailed" }
