# 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. - Page: https://fous.com/methods/thespacedevs.com/get-launch - Method: `thespacedevs.com/get_launch`, version 1 - Website: thespacedevs.com - Returns: mission, rocket, provider, status, result, times, site, orbit, landing, webcast, image, page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `mission` | string | yes | `"Artemis II"` | Mission or rocket name, for example Artemis II or Falcon 9. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "mission": "Artemis II" } ``` Its output: ```json { "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" ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "type": "object", "required": [ "mission" ], "properties": { "mission": { "type": "string", "minLength": 1, "description": "Mission or rocket name, for example Artemis II or Falcon 9." } } } ``` ## Output schema ```json { "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." } } } ``` ## See more - [The Space Devs API: List upcoming launches](https://fous.com/methods/thespacedevs.com/list-upcoming-launches.md): Lists upcoming rocket launches worldwide, with launch windows in UTC and local site time. Results can be filtered by company, country or launch site. - [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds 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. - [Nike API: List upcoming SNKRS releases](https://fous.com/methods/nike.com/list-upcoming-releases.md): Lists upcoming or in-stock Nike SNKRS sneaker releases for a country. Each release has its local launch time and price. - [Hugging Face API: Search Hugging Face Spaces](https://fous.com/methods/huggingface.co/search-spaces.md): Finds public Hugging Face Spaces demos for a task, with descriptions, likes, running status and update dates. - [AniList API: Get next episode](https://fous.com/methods/anilist.co/get-next-episode.md): Finds 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. - [NASA API: Search media](https://fous.com/methods/nasa.gov/search-images.md): Searches NASA public photos, videos or audio by words and creation year, returning matches in relevance order with thumbnails and full-size file links. - [Cricbuzz API: Get live scores](https://fous.com/methods/cricbuzz.com/get-live-scores.md): Lists live, recent and upcoming cricket matches from Cricbuzz with teams, scores, venue and status. Filter by team or series name. - [NASA API: List near-Earth asteroids](https://fous.com/methods/nasa.gov/list-near-earth-asteroids.md): Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status. - [All The Space Devs methods](https://fous.com/methods/thespacedevs.com.md)