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/a7f29a7f-39a9-40d4-9bb2-d9a7b65828dd/?format=api
{ "id": "a7f29a7f-39a9-40d4-9bb2-d9a7b65828dd", "url": "https://ll.thespacedevs.com/2.2.0/launch/a7f29a7f-39a9-40d4-9bb2-d9a7b65828dd/?format=api", "slug": "taurus-3210-formosat-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Taurus 3210 | Formosat-2", "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:54:42Z", "updates": [], "net": "2004-05-20T17:47:03Z", "net_precision": null, "window_end": "2004-05-20T17:47:03Z", "window_start": "2004-05-20T17:47:03Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 100, "url": "https://ll.thespacedevs.com/2.2.0/agencies/100/?format=api", "name": "Orbital Sciences Corporation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "OSC", "description": "", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 72, "consecutive_successful_launches": 0, "successful_launches": 65, "failed_launches": 7, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.orbital.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orbital_Sciences_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_science_image_20251120065555.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_icon_image_20251120065816.png" }, "rocket": { "id": 7182, "configuration": { "id": 387, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/387/?format=api", "name": "Minotaur-C 3210", "active": true, "reusable": false, "description": "American all-solid orbital launch vehicle based on a Pegasus and Peacekeeper rocket.It has been designed as a quick reaction launch vehicle, which can be launched from minimaly prepared places in a matter of a few days.", "family": "Minotaur", "full_name": "Minotaur-C 3210", "manufacturer": { "id": 100, "url": "https://ll.thespacedevs.com/2.2.0/agencies/100/?format=api", "name": "Orbital Sciences Corporation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "OSC", "description": "", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 72, "consecutive_successful_launches": 0, "successful_launches": 65, "failed_launches": 7, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.orbital.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orbital_Sciences_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_science_image_20251120065555.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_icon_image_20251120065816.png" }, "program": [], "variant": "3210", "alias": "", "min_stage": 4, "max_stage": 4, "length": 31.6, "diameter": 2.35, "maiden_flight": "2004-05-20", "launch_cost": null, "launch_mass": 73, "leo_capacity": null, "gto_capacity": null, "to_thrust": 1380, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Minotaur-C", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "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": 5571, "name": "Formosat-2", "description": "ROCSAT 2 (Republic of China Satellite 2) is the second high-resolution Earth observation satellite for the Taiwanese National Space Program Office (NSPO) whose mission is regional remote sensing – to collect data to be used for natural disaster evaluation, agricultural applications, urban planning strategy, environmental monitoring, and ocean surveillance. In addition, the satellite's payload will include an auroral observation instrument.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 55, "url": "https://ll.thespacedevs.com/2.2.0/pad/55/?format=api", "agency_id": 161, "name": "Space Launch Complex 576E", "description": "Launch Complex 576 is a group of rocket launch pads at Vandenberg Space Force Base. The pads were used from 1959 until 1971 to launch SM-65 Atlas missiles. The site was also known as Complex ABRES. Pads in Area 576 include 576A-1, 576A-2 and 576A-3, 576B-1, 576B-2 and 576B-3, 576-C, 576-D, 576-E, OSTF-1 and OSTF-2.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Launch_Complex_576", "map_url": "https://www.google.com/maps?q=34.739444,-120.619167", "latitude": "34.739444", "longitude": "-120.619167", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 862, "total_landing_count": 33 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_55_20200803143429.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 9 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 4657, "location_launch_attempt_count": 618, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 44, "orbital_launch_attempt_count_year": 18, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P971DT22H57M33S", "mission_patches": [], "type": "detailed" }
