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/ae6f284f-20be-43db-8af1-c6981c1cdcbd/?format=api
{ "id": "ae6f284f-20be-43db-8af1-c6981c1cdcbd", "url": "https://ll.thespacedevs.com/2.2.0/launch/ae6f284f-20be-43db-8af1-c6981c1cdcbd/?format=api", "slug": "atlas-v-531-ses-20-ses-21", "flightclub_url": "https://flightclub.io/result?llId=ae6f284f-20be-43db-8af1-c6981c1cdcbd", "r_spacex_api_id": null, "name": "Atlas V 531 | SES-20 & SES-21", "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-14T17:42:37Z", "updates": [ { "id": 2530, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success", "info_url": "https://twitter.com/ulalaunch/status/1577518076446183424", "created_by": "Cosmic_Penguin", "created_on": "2022-10-05T04:37:42Z" }, { "id": 2526, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=ejBteVXNxlQ", "created_by": "SwGustav", "created_on": "2022-10-04T21:36:22Z" }, { "id": 2525, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Coverage live", "info_url": "https://www.youtube.com/watch?v=ejBteVXNxlQ", "created_by": "SwGustav", "created_on": "2022-10-04T21:16:51Z" }, { "id": 2521, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Weather 90%", "info_url": "https://twitter.com/ulalaunch/status/1577324282585260034", "created_by": "Nosu", "created_on": "2022-10-04T15:56:11Z" }, { "id": 2517, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Weather 80%", "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Atlas%20V%20SES%20L-1%20Forecast%20-%204%20Oct%20Launch.pdf", "created_by": "Nosu", "created_on": "2022-10-04T06:54:43Z" }, { "id": 2511, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Weather 70%", "info_url": "https://www.24live.co/live/UFV8o?n=3152425777599903484", "created_by": "Cosmic_Penguin", "created_on": "2022-10-01T16:53:24Z" }, { "id": 2486, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Delayed to Oct 4th due to Hurricane Ian", "info_url": "https://twitter.com/ulalaunch/status/1574873067590909959", "created_by": "SwGustav", "created_on": "2022-09-27T21:43:17Z" }, { "id": 2478, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Weather 20%", "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Atlas%20V%20SES%20L-4%20Forecast%20-%2030%20Sep%20Launch.pdf", "created_by": "Nosu", "created_on": "2022-09-26T13:27:32Z" }, { "id": 2448, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time", "info_url": "https://blog.ulalaunch.com/blog/ses-20/21-commercial-satellite-tandem-stacked-atop-atlas-v", "created_by": "Cosmic_Penguin", "created_on": "2022-09-20T21:06:42Z" }, { "id": 2360, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET September 30", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=51645.msg2406038#msg2406038", "created_by": "Cosmic_Penguin", "created_on": "2022-09-09T07:18:18Z" }, { "id": 2266, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Late September", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-08-22T06:29:08Z" }, { "id": 2023, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET September", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=51645.msg2382581#msg2382581", "created_by": "Cosmic_Penguin", "created_on": "2022-07-02T10:44:32Z" }, { "id": 1442, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET August 2022", "info_url": "https://twitter.com/steviecSES/status/1506386012322377731", "created_by": "Cosmic_Penguin", "created_on": "2022-03-23T04:44:06Z" } ], "net": "2022-10-04T21:36:00Z", "net_precision": null, "window_end": "2022-10-04T22:21:00Z", "window_start": "2022-10-04T21:36:00Z", "probability": 90, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 2737, "configuration": { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/8/?format=api", "name": "Atlas V 531", "active": true, "reusable": false, "description": "Atlas V with 5m Fairing, 3 SRB, 1 Centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 531", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "531", "alias": "", "min_stage": 0, "max_stage": 2, "length": 60.0, "diameter": 3.8, "maiden_flight": "2010-08-14", "launch_cost": "140000000", "launch_mass": 479, "leo_capacity": 15530, "gto_capacity": 7450, "to_thrust": null, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520531_image_20190222030726.jpeg", "info_url": null, "wiki_url": null, "total_launch_count": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "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": 6140, "name": "SES-20 & SES-21", "description": "SES-20 & SES-21 are a pair of C-band communication satellites built by Boeing, using the highly efficient all-electric propulsion BSS-702SP satellite bus.\r\n\r\nThese satellites will enable SES to clear 280MHz of mid-band spectrum for 5G use while seamlessly migrating SES’s existing C-band customers and ensuring the continued delivery of digital television to nearly 120 million American TV homes and other critical data services.", "launch_designator": null, "type": "Communications", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1024, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115 }, "infoURLs": [ { "priority": 10, "source": null, "title": "Atlas V SES-20 SES-21", "description": "A United Launch Alliance (ULA) Atlas V 531 rocket will launch the SES-20 and SES-21 satellites into near-geosynchronous orbit to provide television broadcasting services across the United States. The commercial dual-payload launch is in service to satellite operator SES of Luxembourg. Liftoff will o...", "feature_image": null, "url": "https://www.ulalaunch.com/missions/next-launch/atlas-v-ses-20-ses-21", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Oct. 4 Live Broadcast: Atlas V SES-20/21", "description": "A United Launch Alliance (ULA) Atlas V 531 rocket will launch the SES-20 and SES-21 satellites into near-geosynchronous orbit to provide television broadcast...", "feature_image": "https://i.ytimg.com/vi/ejBteVXNxlQ/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=ejBteVXNxlQ", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520531_image_20190222030726.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6309, "location_launch_attempt_count": 859, "pad_launch_attempt_count": 108, "agency_launch_attempt_count": 155, "orbital_launch_attempt_count_year": 127, "location_launch_attempt_count_year": 29, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 7, "pad_turnaround": "P61DT11H7M", "mission_patches": [], "type": "detailed" }
