# Space Launch API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/spacelaunch-api/..." ``` ## Pricing - **Free** (Free) — 1,000 calls/Mo, 1 req/s - **Basic** ($1/Mo) — 25,000 calls/Mo, 3 req/s - **Pro** ($4/Mo) — 150,000 calls/Mo, 8 req/s - **Mega** ($12/Mo) — 750,000 calls/Mo, 20 req/s ## Endpoints ### Launches #### `GET /v1/agencies` — Space agencies **Parameters:** - `search` (query, optional, string) — Agency name Example: `spacex` - `limit` (query, optional, string) — 1-50 (default 10) Example: `5` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/spacelaunch-api/v1/agencies?search=spacex&limit=5" ``` **Response:** ```json { "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", "failed_launches": null, "total_launch_count": null, "successful_launches": null } ], "returned": 1 }, "meta": { "timestamp": "2026-05-30T18:17:07.183Z", "request_id": "fc650f33-86c7-4793-82c1-10ac99132235" }, "status": "ok", "message": "Agencies retrieved", "success": true } ``` #### `GET /v1/events` — Upcoming spaceflight events **Parameters:** - `limit` (query, optional, string) — 1-50 (default 10) Example: `5` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/spacelaunch-api/v1/events?limit=5" ``` **Response:** ```json { "data": { "count": 30, "results": [ { "id": 1488, "date": "2026-06-09T15:00:00Z", "name": "Artemis III Crew Announcement", "type": "Press Event", "image": null, "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", "image": null, "location": "(98943) Torifune", "news_url": null, "description": "As part of i …(truncated, see openapi.json for full schema) ``` #### `GET /v1/launch` — Launch by id **Parameters:** - `id` (query, required, string) — Launch id (UUID) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/spacelaunch-api/v1/launch" ``` #### `GET /v1/previous` — Previous launches **Parameters:** - `limit` (query, optional, string) — 1-50 (default 10) Example: `5` - `search` (query, optional, string) — Filter by rocket/mission - `offset` (query, optional, string) — Pagination (1-based) Example: `1` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/spacelaunch-api/v1/previous?limit=5&offset=1" ``` **Response:** ```json { "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", "probability": null, "webcast_live": false, "window_ …(truncated, see openapi.json for full schema) ``` #### `GET /v1/upcoming` — Upcoming launches **Parameters:** - `limit` (query, optional, string) — 1-50 (default 10) Example: `5` - `search` (query, optional, string) — Filter by rocket/mission - `offset` (query, optional, string) — Pagination (1-based) Example: `1` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/spacelaunch-api/v1/upcoming?limit=5&offset=1" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/spacelaunch-api OpenAPI spec: https://www.oanor.com/api/spacelaunch-api/openapi.json