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/a8d8d683-3ab0-40ab-beb0-e66bb55afd91/?format=api
{ "id": "a8d8d683-3ab0-40ab-beb0-e66bb55afd91", "url": "https://lldev.thespacedevs.com/2.2.0/launch/a8d8d683-3ab0-40ab-beb0-e66bb55afd91/?format=api", "slug": "nebula-1-demo-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Nebula-1 | Demo Flight", "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": "2026-04-05T19:35:40Z", "updates": [ { "id": 14583, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch test profile target and launch site.", "info_url": "https://x.com/raz_liu/status/2034591781556457658", "created_by": "Cosmic_Penguin", "created_on": "2026-04-05T19:35:00Z" }, { "id": 13096, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://x.com/CNSpaceflight/status/1985169720224707018", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T16:45:00Z" } ], "net": "2026-06-30T00:00:00Z", "net_precision": { "id": 12, "name": "Year Half 1", "abbrev": "H1", "description": "The T-0 is expected in the first half of the given year." }, "window_end": "2026-06-30T00:00:00Z", "window_start": "2026-06-30T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1102, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1102/?format=api", "name": "Deep Blue Aerospace", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "DBA Space", "description": "Chinese private launch services provider, currently developing the Nebula series of orbital launch vehicles.", "administrator": null, "founding_year": "2016", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.dbaspace.com/indexs.html", "wiki_url": "https://en.wikipedia.org/wiki/Deep_Blue_Aerospace", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/deep_blue_aeros_image_20251120062051.jpg", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/deep_blue_aeros_image_20251120062112.png" }, "rocket": { "id": 8827, "configuration": { "id": 545, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/545/?format=api", "name": "Nebula-1", "active": true, "reusable": true, "description": "", "family": "", "full_name": "Nebula-1", "manufacturer": { "id": 1102, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1102/?format=api", "name": "Deep Blue Aerospace", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "DBA Space", "description": "Chinese private launch services provider, currently developing the Nebula series of orbital launch vehicles.", "administrator": null, "founding_year": "2016", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.dbaspace.com/indexs.html", "wiki_url": "https://en.wikipedia.org/wiki/Deep_Blue_Aerospace", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/deep_blue_aeros_image_20251120062051.jpg", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/deep_blue_aeros_image_20251120062112.png" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 2, "length": 35.0, "diameter": 3.35, "maiden_flight": null, "launch_cost": null, "launch_mass": 150, "leo_capacity": 2000, "gto_capacity": null, "to_thrust": 2130, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Deep_Blue_Aerospace#Nebula_1", "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": 7418, "name": "Demo Flight", "description": "First test launch of Deep Blue Aerospace’s Nebula-1 rocket.\r\n\r\nThe test flight profile is reported to be sub-orbital.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 252, "url": "https://lldev.thespacedevs.com/2.2.0/pad/252/?format=api", "agency_id": 88, "name": "Land Launch Pad 1", "description": "First land launch pad at the Haiyang Oriental Spaceport, built on the former tourist attraction site of the reclaimed-island Lianli Island. It is described as a \"sea-launch and booster recovery testing launch site\".", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=36.664312,121.188333", "latitude": "36.664312", "longitude": "121.188333", "location": { "id": 185, "url": "https://lldev.thespacedevs.com/2.2.0/location/185/?format=api", "name": "Haiyang Oriental Spaceport", "country_code": "CHN", "description": "Chinese orbital launch vehicle launches supporting sea port located at Haiyang, Shandong Province, with dedicated piers and rocket/payload processing facilities for Chinese launch vehicles’ sea launches, and (as part of its expansion project) land based launch pads on artificial islands for various test vehicles and launch vehicles of private and government launch services providers.\r\n\r\nIn operation as a remote base of Taiyuan Satellite Launch Center since 2019.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 24, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_land_launch_pad_1_20260405193202.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 26, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": null, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
