{"openapi":"3.1.0","info":{"title":"Space Launch API","version":"1.0.0","description":"Track rocket launches from around the world. List upcoming and past launches with launch windows and live status, search by rocket or mission, get full detail for any launch, browse the space agencies behind them, and follow upcoming spaceflight events. Every launch comes as a clean record with the rocket configuration and family, launch service provider, mission name, type, orbit and description, pad and location, weather probability, webcast-live flag and imagery — sourced from The Space Devs’ Launch Library 2. Delivered through a fast, reliable API, ideal for countdown widgets, space-news sites, education tools, calendars and hobbyist apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/spacelaunch-api","description":"oanor gateway"}],"tags":[{"name":"Launches"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/agencies":{"get":{"operationId":"get_v1_agencies","tags":["Launches"],"summary":"Space agencies","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Agency name","schema":{"type":"string"},"example":"spacex"},{"name":"limit","in":"query","required":false,"description":"1-50 (default 10)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"results":[{"id":121,"name":"SpaceX","type":"Commercial","abbrev":"SpX","logo_url":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png","description":"Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.","country_code":"USA","founding_year":"2002"}],"returned":1},"meta":{"timestamp":"2026-05-30T18:17:07.183Z","request_id":"fc650f33-86c7-4793-82c1-10ac99132235"},"status":"ok","message":"Agencies retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/events":{"get":{"operationId":"get_v1_events","tags":["Launches"],"summary":"Upcoming spaceflight events","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"1-50 (default 10)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"results":[{"id":1488,"date":"2026-06-09T15:00:00Z","name":"Artemis III Crew Announcement","type":"Press Event","location":"Johnson Space Center, Houston, TX, USA","news_url":"https://www.nasa.gov/news-release/nasa-to-announce-artemis-iii-crew-provide-mission-progress-update/","description":"NASA will provide an update on the agency’s Artemis III mission and announce the astronauts assigned to the test flight.\r\n\r\nArtemis III will launch four astronauts from NASA’s Kennedy Space Center in Florida aboard the Orion spacecraft on the SLS (Space Launch System) rocket. The mission will test critical rendezvous and docking capabilities between Orion and commercial human landing systems needed to deliver astronauts to the lunar surface. Building on the successful Artemis II crewed test flight in April, Artemis III will pave the way for future surface missions.","webcast_live":false},{"id":1283,"date":"2026-07-31T00:00:00Z","name":"Hayabusa2 S-Type Asteroid (98943) Torifune Flyby","type":"Flyby","location":"(98943) Torifune","description":"As part of its mission extension, JAXA's Hayabusa2 spacecraft will observe S-type asteroid (98943) Torifune during a high-speed fly-by.","webcast_live":false},{"id":1454,"date":"2026-08-12T15:35:23Z","name":"Total Solar Eclipse in Europe","type":"Celestial Event","location":"Europe & Northern Atlantic","news_url":"https://en.wikipedia.org/wiki/Solar_eclipse_of_August_12,_2026","description":"On 12 August 2026, a solar eclipse will be visible across parts of Europe and the north Atlantic. The path of totality will cross Greenland, Iceland, Spain and a small area of northeastern Portugal. Other parts of Europe will see a partial solar eclipse.","webcast_live":false},{"id":1017,"date":"2026-09-30T00:00:00Z","name":"Juice Earth Flyby","type":"Flyby","location":"Earth","description":"Third flyby of ESA's Jupiter Icy Moons Explorer (Juice) mission on its way to the Jovian system.","webcast_live":false},{"id":394,"date":"2026-11-30T00:00:00Z","name":"BepiColombo Mercury Orbit Insertion","type":"Orbital Insertion","location":"Mercury","news_url":"https://sci.esa.int/web/bepicolombo/-/47346-fact-sheet","description":"Orbital insertion around Mercury of the ESA-JAXA BepiColombo mission.","webcast_live":false}],"returned":5},"meta":{"timestamp":"2026-05-30T18:17:07.935Z","request_id":"010f0536-64d8-4b9d-a8b4-c1235b4ee879"},"status":"ok","message":"Events retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/launch":{"get":{"operationId":"get_v1_launch","tags":["Launches"],"summary":"Launch by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Launch id (UUID)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/previous":{"get":{"operationId":"get_v1_previous","tags":["Launches"],"summary":"Previous launches","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"1-50 (default 10)","schema":{"type":"string"},"example":"5"},{"name":"search","in":"query","required":false,"description":"Filter by rocket/mission","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination (1-based)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7521,"results":[{"id":"0ab3587d-bb8c-4515-a321-2ec154840659","net":"2026-05-30T18:07:00Z","pad":{"name":"Launch Complex 3 (LC-3/LA-1)","location":"Xichang Satellite Launch Center, People's Republic of China"},"name":"Long March 2D | Unknown Payload","slug":"long-march-2d-unknown-payload","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg","rocket":{"name":"Long March 2D","family":"Long March","full_name":"Long March 2D"},"status":{"name":"Go for Launch","abbrev":"Go"},"mission":{"name":"Unknown Payload","type":"Unknown","orbit":"Unknown","description":"Details TBD."},"provider":{"name":"China Aerospace Science and Technology Corporation","type":"Government"},"window_end":"2026-05-30T18:17:00Z","webcast_live":false,"window_start":"2026-05-30T17:57:00Z"},{"id":"a7341350-789e-4f61-99a4-a61ebc40c05b","net":"2026-05-30T15:25:10Z","pad":{"name":"Space Launch Complex 4E","location":"Vandenberg SFB, CA, USA"},"name":"Falcon 9 Block 5 | Starlink Group 17-41","slug":"falcon-9-block-5-starlink-group-17-41","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png","rocket":{"name":"Falcon 9","family":"Falcon","full_name":"Falcon 9 Block 5"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"Starlink Group 17-41","type":"Communications","orbit":"Low Earth Orbit","description":"A batch of 24 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system."},"provider":{"name":"SpaceX","type":"Commercial"},"window_end":"2026-05-30T18:00:00Z","webcast_live":false,"window_start":"2026-05-30T14:00:00Z"},{"id":"ff0a6a32-6513-4e85-9fd8-a2d022add74d","net":"2026-05-29T23:53:00Z","pad":{"name":"Space Launch Complex 41","location":"Cape Canaveral SFS, FL, USA"},"name":"Atlas V 551 | Amazon Leo (LA-07)","slug":"atlas-v-551-amazon-leo-la-07","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520551_image_20190224012316.jpeg","rocket":{"name":"Atlas V 551","family":"Atlas","full_name":"Atlas V 551"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"Amazon Leo (LA-07)","type":"Communications","orbit":"Low Earth Orbit","description":"Amazon Leo, formerly known as Project Kuiper, is a mega constellation of satellites in Low Earth Orbit that will offer broadband internet access, this constellation will be managed by Kuiper Systems LLC, a subsidiary of Amazon. This constellation is planned to be composed of 3,276 satellites. The satellites are projected to be placed in 98 orbital planes in three orbital layers, one at 590 km, 610 km and 630 km altitude.\r\n\r\n29 satellites are carried on this launch."},"provider":{"name":"United Launch Alliance","type":"Commercial"},"window_end":"2026-05-30T00:02:30Z","probability":45,"webcast_live":false,"window_start":"2026-05-29T23:33:30Z","weather_concerns":"Cumulus Cloud Rule, Anvil Cloud Rules, Surface Electric Fields Rule"},{"id":"384fb817-2a18-46ec-b294-613c08ecea52","net":"2026-05-29T12:57:15Z","pad":{"name":"Space Launch Complex 40","location":"Cape Canaveral SFS, FL, USA"},"name":"Falcon 9 Block 5 | Starlink Group 10-53","slug":"falcon-9-block-5-starlink-group-10-53","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png","rocket":{"name":"Falcon 9","family":"Falcon","full_name":"Falcon 9 Block 5"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"Starlink Group 10-53","type":"Communications","orbit":"Low Earth Orbit","description":"A batch of 29 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system."},"provider":{"name":"SpaceX","type":"Commercial"},"window_end":"2026-05-29T15:52:00Z","probability":80,"webcast_live":false,"window_start":"2026-05-29T11:52:00Z","weather_concerns":"Cumulus Cloud Rule, Anvil Cloud Rules"},{"id":"6d2beb1a-6869-4505-9fc1-a4aa224178e2","net":"2026-05-26T16:16:00Z","pad":{"name":"201","location":"Wenchang Space Launch Site, People's Republic of China"},"name":"Long March 7A | TJSW-24","slug":"long-march-7a-tjsw-24","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cz-7a_launch_2_image_20251206093324.jpeg","rocket":{"name":"Long March 7A","family":"Long March","full_name":"Long March 7A"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"TJSW-24","type":"Government/Top Secret","orbit":"Geostationary Transfer Orbit","description":"Chinese classified satellite claimed to be for communication technology test purposes. Actual mission not known."},"provider":{"name":"China Aerospace Science and Technology Corporation","type":"Government"},"window_end":"2026-05-26T17:08:00Z","webcast_live":false,"window_start":"2026-05-26T16:08:00Z"}],"returned":5},"meta":{"timestamp":"2026-05-30T18:17:08.791Z","request_id":"64792d83-d6f5-4e24-bd69-bfde2a9f3ade"},"status":"ok","message":"Previous launches retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/upcoming":{"get":{"operationId":"get_v1_upcoming","tags":["Launches"],"summary":"Upcoming launches","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"1-50 (default 10)","schema":{"type":"string"},"example":"5"},{"name":"search","in":"query","required":false,"description":"Filter by rocket/mission","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination (1-based)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":357,"results":[{"id":"ff0a6a32-6513-4e85-9fd8-a2d022add74d","net":"2026-05-29T23:53:00Z","pad":{"name":"Space Launch Complex 41","location":"Cape Canaveral SFS, FL, USA"},"name":"Atlas V 551 | Amazon Leo (LA-07)","slug":"atlas-v-551-amazon-leo-la-07","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520551_image_20190224012316.jpeg","rocket":{"name":"Atlas V 551","family":"Atlas","full_name":"Atlas V 551"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"Amazon Leo (LA-07)","type":"Communications","orbit":"Low Earth Orbit","description":"Amazon Leo, formerly known as Project Kuiper, is a mega constellation of satellites in Low Earth Orbit that will offer broadband internet access, this constellation will be managed by Kuiper Systems LLC, a subsidiary of Amazon. This constellation is planned to be composed of 3,276 satellites. The satellites are projected to be placed in 98 orbital planes in three orbital layers, one at 590 km, 610 km and 630 km altitude.\r\n\r\n29 satellites are carried on this launch."},"provider":{"name":"United Launch Alliance","type":"Commercial"},"window_end":"2026-05-30T00:02:30Z","probability":45,"webcast_live":false,"window_start":"2026-05-29T23:33:30Z","weather_concerns":"Cumulus Cloud Rule, Anvil Cloud Rules, Surface Electric Fields Rule"},{"id":"a7341350-789e-4f61-99a4-a61ebc40c05b","net":"2026-05-30T15:25:10Z","pad":{"name":"Space Launch Complex 4E","location":"Vandenberg SFB, CA, USA"},"name":"Falcon 9 Block 5 | Starlink Group 17-41","slug":"falcon-9-block-5-starlink-group-17-41","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png","rocket":{"name":"Falcon 9","family":"Falcon","full_name":"Falcon 9 Block 5"},"status":{"name":"Launch Successful","abbrev":"Success"},"mission":{"name":"Starlink Group 17-41","type":"Communications","orbit":"Low Earth Orbit","description":"A batch of 24 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system."},"provider":{"name":"SpaceX","type":"Commercial"},"window_end":"2026-05-30T18:00:00Z","webcast_live":false,"window_start":"2026-05-30T14:00:00Z"},{"id":"0ab3587d-bb8c-4515-a321-2ec154840659","net":"2026-05-30T18:07:00Z","pad":{"name":"Launch Complex 3 (LC-3/LA-1)","location":"Xichang Satellite Launch Center, People's Republic of China"},"name":"Long March 2D | Unknown Payload","slug":"long-march-2d-unknown-payload","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg","rocket":{"name":"Long March 2D","family":"Long March","full_name":"Long March 2D"},"status":{"name":"Go for Launch","abbrev":"Go"},"mission":{"name":"Unknown Payload","type":"Unknown","orbit":"Unknown","description":"Details TBD."},"provider":{"name":"China Aerospace Science and Technology Corporation","type":"Government"},"window_end":"2026-05-30T18:17:00Z","webcast_live":false,"window_start":"2026-05-30T17:57:00Z"},{"id":"cfff5e89-af2e-46b1-9446-7b0f18de4ef7","net":"2026-06-03T08:02:00Z","pad":{"name":"Space Launch Complex 40","location":"Cape Canaveral SFS, FL, USA"},"name":"Falcon 9 Block 5 | Starlink Group 10-43","slug":"falcon-9-block-5-starlink-group-10-43","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png","rocket":{"name":"Falcon 9","family":"Falcon","full_name":"Falcon 9 Block 5"},"status":{"name":"Go for Launch","abbrev":"Go"},"mission":{"name":"Starlink Group 10-43","type":"Communications","orbit":"Low Earth Orbit","description":"A batch of 29 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system."},"provider":{"name":"SpaceX","type":"Commercial"},"window_end":"2026-06-03T12:02:00Z","webcast_live":false,"window_start":"2026-06-03T08:02:00Z"},{"id":"4936311a-af7c-4b05-8d7b-3eea59fc0f11","net":"2026-06-03T14:00:00Z","pad":{"name":"Space Launch Complex 4E","location":"Vandenberg SFB, CA, USA"},"name":"Falcon 9 Block 5 | Starlink Group 17-47","slug":"falcon-9-block-5-starlink-group-17-47","image":"https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png","rocket":{"name":"Falcon 9","family":"Falcon","full_name":"Falcon 9 Block 5"},"status":{"name":"Go for Launch","abbrev":"Go"},"mission":{"name":"Starlink Group 17-47","type":"Communications","orbit":"Low Earth Orbit","description":"A batch of 24 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system."},"provider":{"name":"SpaceX","type":"Commercial"},"window_end":"2026-06-03T18:00:00Z","webcast_live":false,"window_start":"2026-06-03T14:00:00Z"}],"returned":5},"meta":{"timestamp":"2026-05-30T18:17:09.578Z","request_id":"a02ba622-cdad-44b2-a191-cbadd0212258"},"status":"ok","message":"Upcoming launches retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":1,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":100,"monthly_call_quota":25000,"rps_limit":3,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":400,"monthly_call_quota":150000,"rps_limit":8,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":1200,"monthly_call_quota":750000,"rps_limit":20,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/spacelaunch-api"}