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/a81fcb21-ed57-47ef-ab57-33ddd9c6ffcd/?format=api
{ "id": "a81fcb21-ed57-47ef-ab57-33ddd9c6ffcd", "url": "https://ll.thespacedevs.com/2.2.0/launch/a81fcb21-ed57-47ef-ab57-33ddd9c6ffcd/?format=api", "slug": "hanbit-nano-spaceward", "flightclub_url": null, "r_spacex_api_id": null, "name": "HANBIT-Nano | Spaceward", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-11-21T03:35:11Z", "updates": [ { "id": 12969, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to NET December 17.", "info_url": "https://x.com/innospacecorp/status/1991693571087577573", "created_by": "Cosmic_Penguin", "created_on": "2025-11-21T03:35:00Z" }, { "id": 12797, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Go for launch.", "info_url": "https://x.com/innospacecorp/status/1986587322708832469", "created_by": "Cosmic_Penguin", "created_on": "2025-11-07T00:36:00Z" }, { "id": 12689, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET November.", "info_url": "https://voi.id/en/amp/527007", "created_by": "Cosmic_Penguin", "created_on": "2025-10-27T19:25:00Z" }, { "id": 12635, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://spacenews.com/innospace-gets-license-for-first-orbital-launch-attempt/", "created_by": "Nosu", "created_on": "2025-10-21T12:01:00Z" } ], "net": "2025-12-17T00:00:00Z", "net_precision": { "id": 5, "name": "Day", "abbrev": "DAY", "description": "The T-0 is expected on the given day." }, "window_end": "2025-12-17T00:00:00Z", "window_start": "2025-12-17T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1098, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1098/?format=api", "name": "Innospace", "featured": false, "type": "Private", "country_code": "KOR", "abbrev": "IS", "description": "Innospace is a South Korean startup company specializing in developing hybrid space rocket.", "administrator": "CEO: Kim Soo-jong", "founding_year": "2017", "launchers": "HANBIT", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.innospc.com/main", "wiki_url": "https://en.wikipedia.org/wiki/Innospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png" }, "rocket": { "id": 8777, "configuration": { "id": 530, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/530/?format=api", "name": "HANBIT-Nano", "active": true, "reusable": false, "description": "Two-stage launch vehicle developed by South Korean space startup Innospace.", "family": "HANBIT", "full_name": "HANBIT-Nano", "manufacturer": { "id": 1098, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1098/?format=api", "name": "Innospace", "featured": false, "type": "Private", "country_code": "KOR", "abbrev": "IS", "description": "Innospace is a South Korean startup company specializing in developing hybrid space rocket.", "administrator": "CEO: Kim Soo-jong", "founding_year": "2017", "launchers": "HANBIT", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.innospc.com/main", "wiki_url": "https://en.wikipedia.org/wiki/Innospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png" }, "program": [], "variant": "Nano", "alias": "", "min_stage": 2, "max_stage": 2, "length": 21.8, "diameter": 1.4, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": 245, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hanbit-nano_gro_image_20251021114236.jpg", "info_url": "https://www.innospc.com/page/sub01_01_1", "wiki_url": "https://en.wikipedia.org/wiki/Innospace_HANBIT-NANO", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7368, "name": "Spaceward", "description": "Maiden orbital launch attempt for the South Korean stratup Innospace and its HANBIT-Nano small launch vehicle. Onboard this flight are five small satellites from the Brazilian space agency AEB, Brazilian university Universidade Federal do Maranhão and Indian startup Grahaa Space, as well as three payloads from AEB and Brazilian company Castro Leite Consultoria that will remain attached to the rocket, and an empty aluminium can from the South Korean beverage company Brewguru.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/agencies/12/?format=api", "name": "Brazilian Space Agency", "featured": false, "type": "Government", "country_code": "BRA", "abbrev": "AEB", "description": "The Brazilian Space Agency is a space agency in South America. They work in partnership with the US and Russia aboard the ISS. It was previously operated by the military until 1994. They now operate largely in tandem with other nations. They run a spaceport and rocket launch site both in Brazil. They built the VLM small satellite launch system in tandem with Germany. The VLS-1 was intended to be a primary launch vehicle for the BSA, but it failed 3 times and was canceled. They have restarted work on the system in tandem with the Russian Space Agency.", "administrator": "Administrator: Marco Antonio Chamon", "founding_year": "1961", "launchers": "VLM | VLS", "spacecraft": "None", "launch_library_url": null, "total_launch_count": 2, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.gov.br/aeb/pt-br", "wiki_url": "https://en.wikipedia.org/wiki/Brazilian_Space_Agency", "logo_url": null, "image_url": null, "nation_url": null }, { "id": 1098, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1098/?format=api", "name": "Innospace", "featured": false, "type": "Private", "country_code": "KOR", "abbrev": "IS", "description": "Innospace is a South Korean startup company specializing in developing hybrid space rocket.", "administrator": "CEO: Kim Soo-jong", "founding_year": "2017", "launchers": "HANBIT", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.innospc.com/main", "wiki_url": "https://en.wikipedia.org/wiki/Innospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 240, "url": "https://ll.thespacedevs.com/2.2.0/pad/240/?format=api", "agency_id": 1098, "name": "HANBIT Pad", "description": "Launchpad of the HANBIT rockets developed by South Korean company Innospace.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Alc%C3%A2ntara_Space_Center", "map_url": "https://www.google.com/maps?q=-2.31698,-44.36873", "latitude": "-2.31698", "longitude": "-44.36873", "location": { "id": 150, "url": "https://ll.thespacedevs.com/2.2.0/location/150/?format=api", "name": "Alcântara Space Center, Federative Republic of Brazil", "country_code": "BRA", "description": "The Alcântara Space Center, formerly known as Alcântara Launch Center is a space center and launching facility of the Brazilian Space Agency in the city of Alcântara, located on Brazil's northern Atlantic coast, in the state of Maranhão.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_150_20200803142405.jpg", "timezone_name": "America/Fortaleza", "total_launch_count": 3, "total_landing_count": 0 }, "country_code": "BRA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_hanbit_pad_20251021114902.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hanbit-nano_gro_image_20251021114236.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7149, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 300, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1003DT6H8M", "mission_patches": [ { "id": 1194, "name": "Spaceward Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/spaceward2520p_mission_patch_20251021115940.png", "agency": { "id": 1098, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1098/?format=api", "name": "Innospace", "type": "Private" } } ], "type": "detailed" }
