The Space Devs API: Get launch by mission or rocket name
Finds a launch by mission or rocket name. Picks the next upcoming match, otherwise the most recent past match, and returns its details.
Unofficial. Not affiliated with or endorsed by The Space Devs.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Mission, required
mission Mission or rocket name, for example Artemis II or Falcon 9.
Artemis II
Input as JSON
{ "mission": "Artemis II"}Output
{ "result": "success", "rocket": "Space Launch System Block 1", "status": "Launch Successful", "page_link": "https://ll.thespacedevs.com/2.3.0/launches/41699701-2ef4-4b0c-ac9d-6757820cde87/" , "image_link": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_launch_sy_image_20260405204639.jpg" , "launch_site": "Launch Complex 39B, Kennedy Space Center, FL, USA", "mission_name": "Artemis II", "target_orbit": "Lunar flyby", "webcast_link": "https://www.youtube.com/watch?v=Tf_UjBMIzNo" , "launch_company": "National Aeronautics and Space Administration", "mission_description": "Artemis II is the first crewed mission as part of the Artemis program. Artemis II will send a crew of 4 - 3 Americans and 1 Canadian around the moon and return them back to Earth.\r\n\r\nThe mission will test the core systems of NASA's Orion spacecraft including the critical life support system, among o…", "launch_date_time_utc": "2026-04-01T22:35:12+00:00", "booster_landing_result": null, "launch_date_time_local": "2026-04-01T18:35:12-04:00", "booster_landing_attempt": "Not listed", "spacecraft_or_cargo_carried": [ "Orion Integrity" ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"thespacedevs.com/get_launch","input":{"mission":"Artemis II"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "thespacedevs.com/get_launch" , "input": { "mission": "Artemis II" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "thespacedevs.com/get_launch" , "input": { "mission": "Artemis II" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run thespacedevs.com/get_launch# with {"mission":"Artemis II"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "mission" ], "properties": { "mission": { "type": "string", "minLength": 1, "description": "Mission or rocket name, for example Artemis II or Falcon 9." } }}Output schema
{ "type": "object", "required": [ "mission_name", "rocket", "launch_company", "status", "result", "launch_date_time_utc", "launch_date_time_local", "launch_site", "mission_description", "target_orbit", "booster_landing_attempt", "booster_landing_result", "webcast_link", "image_link", "page_link", "spacecraft_or_cargo_carried" ], "properties": { "result": { "type": "string", "description": "Success, failure, partial failure, or not yet launched" }, "rocket": { "type": [ "string", "null" ], "description": "Rocket model" }, "status": { "type": [ "string", "null" ], "description": "Launch status in words" }, "page_link": { "type": "string", "description": "Launch detail page URL" }, "image_link": { "type": [ "string", "null" ], "description": "Launch image URL" }, "launch_site": { "type": [ "string", "null" ], "description": "Launch pad and location" }, "mission_name": { "type": "string", "description": "Mission name" }, "target_orbit": { "type": [ "string", "null" ], "description": "Target orbit" }, "webcast_link": { "type": [ "string", "null" ], "description": "Webcast URL" }, "launch_company": { "type": [ "string", "null" ], "description": "Launch provider" }, "mission_description": { "type": [ "string", "null" ], "description": "Description of the mission" }, "launch_date_time_utc": { "type": [ "string", "null" ], "description": "Launch time in UTC, ISO 8601" }, "booster_landing_result": { "type": [ "string", "null" ], "description": "Booster landing outcome or plan in words" }, "launch_date_time_local": { "type": [ "string", "null" ], "description": "Launch time at the launch site, ISO 8601 with offset" }, "booster_landing_attempt": { "type": "string", "description": "Yes, no, or not listed" }, "spacecraft_or_cargo_carried": { "type": "array", "items": { "type": "string" }, "description": "Names of carried spacecraft or payloads listed for this launch." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
thespacedevs.com/get_launch- Returns
- mission, rocket, provider, status, result, times, site, orbit, landing, webcast, image, page link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method thespacedevs.com/get_launch with the inputs above.
Ask your agent
- When is the next launch for the Falcon 9 rocket and what are its details?
- Find the upcoming Artemis II mission launch time and landing info
- What was the most recent Starship flight result and where did it launch from?
- Show me the next Electron launch on thespacedevs.com with its orbit and webcast link
- Look up the latest Long March 5 launch status, provider, and launch site
See more
All The Space Devs methodsLists upcoming rocket launches worldwide, with launch windows in UTC and local site time. Results can be filtered by company, country or launch site.
thespacedevs.com/list_upcoming_launchesFinds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list.
nasa.gov/get_iss_sightingsLists upcoming or in-stock Nike SNKRS sneaker releases for a country. Each release has its local launch time and price.
nike.com/list_upcoming_releasesFinds public Hugging Face Spaces demos for a task, with descriptions, likes, running status and update dates.
huggingface.co/search_spacesFinds the most popular anime matching a name on AniList and returns its next scheduled episode with local air time, status, episode count and streaming links.
anilist.co/get_next_episodeSearches NASA public photos, videos or audio by words and creation year, returning matches in relevance order with thumbnails and full-size file links.
nasa.gov/search_imagesLists live, recent and upcoming cricket matches from Cricbuzz with teams, scores, venue and status. Filter by team or series name.
cricbuzz.com/get_live_scoresLists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status.
nasa.gov/list_near_earth_asteroids