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/b7c38b80-6ce7-4ab0-8010-19ee11e26fc5/?format=api
{ "id": "b7c38b80-6ce7-4ab0-8010-19ee11e26fc5", "url": "https://lldev.thespacedevs.com/2.2.0/launch/b7c38b80-6ce7-4ab0-8010-19ee11e26fc5/?format=api", "slug": "smart-dragon-3-prsc-eo2-6-satellites", "flightclub_url": null, "r_spacex_api_id": null, "name": "Smart Dragon 3 | PRSC-EO2 & 6 satellites", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2026-02-15T07:46:02Z", "updates": [ { "id": 13467, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to December 29 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2746187#msg2746187", "created_by": "Cosmic_Penguin", "created_on": "2025-12-25T13:26:00Z" }, { "id": 13633, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET January 25 per new NOTAM, to be confirmed.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2750729#msg2750729", "created_by": "Cosmic_Penguin", "created_on": "2026-01-14T01:57:00Z" }, { "id": 13479, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch apparently delayed with launch ship observed to have left its launch location, to be confirmed.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64067.msg2746542#msg2746542", "created_by": "Cosmic_Penguin", "created_on": "2025-12-27T19:38:00Z" }, { "id": 13728, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted back to NET January TBD per cancellation of NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=64067.msg2752344#msg2752344", "created_by": "Cosmic_Penguin", "created_on": "2026-01-20T20:03:00Z" }, { "id": 13891, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for February 11 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2757200#msg2757200", "created_by": "Cosmic_Penguin", "created_on": "2026-02-05T16:07:00Z" }, { "id": 13910, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to February 12 per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2758353#msg2758353", "created_by": "Cosmic_Penguin", "created_on": "2026-02-09T06:20:00Z" }, { "id": 13937, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://m.weibo.cn/detail/5265518990986687", "created_by": "Cosmic_Penguin", "created_on": "2026-02-12T08:08:00Z" }, { "id": 13530, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET January 20 per new NOTAMs, to be confirmed.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2748400#msg2748400", "created_by": "Cosmic_Penguin", "created_on": "2026-01-07T01:56:00Z" }, { "id": 13439, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; Payload identity uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2745524#msg2745524", "created_by": "Cosmic_Penguin", "created_on": "2025-12-22T15:53:00Z" } ], "net": "2026-02-12T06:37:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2026-02-12T06:47:00Z", "window_start": "2026-02-12T06:26:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 272, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/272/?format=api", "name": "China Rocket Co. Ltd.", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "CHNR", "description": "China Rocket Co. Ltd. is a spinoff of China’s state-owned launch vehicle manufacturer using a “commercial business model”.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": null, "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520rocket2520co.2520ltd._logo_20221001084159.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china_rocket_co_image_20240922154013.jpg" }, "rocket": { "id": 8861, "configuration": { "id": 484, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/484/?format=api", "name": "Smart Dragon 3", "active": true, "reusable": false, "description": "Smart Dragon-3 is a solid fuel orbital rocket designed by a subsidiary of the state-owned CASC group built for the commercial market.", "family": "Smart Dragon", "full_name": "Smart Dragon 3", "manufacturer": { "id": 272, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/272/?format=api", "name": "China Rocket Co. Ltd.", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "CHNR", "description": "China Rocket Co. Ltd. is a spinoff of China’s state-owned launch vehicle manufacturer using a “commercial business model”.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": null, "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520rocket2520co.2520ltd._logo_20221001084159.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china_rocket_co_image_20240922154013.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": null, "max_stage": null, "length": 32.0, "diameter": 2.64, "maiden_flight": "2022-12-09", "launch_cost": null, "launch_mass": 140, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/smart_dragon_3__image_20240925074606.jpg", "info_url": null, "wiki_url": null, "total_launch_count": 10, "consecutive_successful_launches": 10, "successful_launches": 10, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7452, "name": "PRSC-EO2 & 6 satellites", "description": "Carried 7 satellites to sun-synchronous orbit, including PRSC-EO2 (Earth observation satellite for the Pakistan government's SUPARCO) & CUHK-1. Details on other payloads to be confirmed.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 251, "url": "https://lldev.thespacedevs.com/2.2.0/pad/251/?format=api", "agency_id": 88, "name": "South China Sea (launch location 3)", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=21.366667,112.116667", "latitude": "21.366667", "longitude": "112.116667", "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_south_china_sea_2528launch_location_32529_20260116130538.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/smart_dragon_3__image_20240925074606.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7203, "location_launch_attempt_count": 23, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 10, "orbital_launch_attempt_count_year": 30, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
