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/57d675d1-9a50-4c62-bee0-915c8c26befe/?format=api
{ "id": "57d675d1-9a50-4c62-bee0-915c8c26befe", "url": "https://lldev.thespacedevs.com/2.2.0/launch/57d675d1-9a50-4c62-bee0-915c8c26befe/?format=api", "slug": "gravity-1-3-satellites", "flightclub_url": null, "r_spacex_api_id": null, "name": "Gravity-1 | 3 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-01-16T13:08:19Z", "updates": [ { "id": 12499, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Adding launch per NOTAMs; Payload identities uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2723595#msg2723595", "created_by": "Cosmic_Penguin", "created_on": "2025-10-07T14:05:00Z" }, { "id": 12537, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://weibo.com/l/wblive/p/show/1022:2321325220483980722309", "created_by": "Cosmic_Penguin", "created_on": "2025-10-11T02:22:00Z" }, { "id": 12538, "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/5220516692493506", "created_by": "Cosmic_Penguin", "created_on": "2025-10-11T03:05:00Z" } ], "net": "2025-10-11T02:20:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2025-10-11T02:32:00Z", "window_start": "2025-10-11T02:10:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1080, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1080/?format=api", "name": "Orienspace Technology", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "OrienSpace", "description": "Galactic Energy is a private aerospace company headquartered in Yantai, Shandong, China, established in 2020. The company is developing the Gravity Series of satellite launch vehicles.", "administrator": null, "founding_year": "2020", "launchers": "Gravity-1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.orienspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orienspace", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_logo_20240112075736.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_nation_20240112075637.png" }, "rocket": { "id": 8759, "configuration": { "id": 503, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/503/?format=api", "name": "Gravity-1", "active": false, "reusable": false, "description": "A 4 stage launch vehicle by Chinese private company OrienSpace, consisting of 5 solid rocket motors clustered together but with the center motor igniting just before boosters separation. The upper two stages also uses solid fuel.", "family": "", "full_name": "Gravity-1", "manufacturer": { "id": 1080, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1080/?format=api", "name": "Orienspace Technology", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "OrienSpace", "description": "Galactic Energy is a private aerospace company headquartered in Yantai, Shandong, China, established in 2020. The company is developing the Gravity Series of satellite launch vehicles.", "administrator": null, "founding_year": "2020", "launchers": "Gravity-1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.orienspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orienspace", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_logo_20240112075736.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_nation_20240112075637.png" }, "program": [], "variant": "Gravity-1", "alias": "", "min_stage": 3, "max_stage": 3, "length": 29.4, "diameter": null, "maiden_flight": "2024-01-11", "launch_cost": null, "launch_mass": 405, "leo_capacity": 6500, "gto_capacity": null, "to_thrust": 5880, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-1_image_20240108105446.jpeg", "info_url": "https://www.orienspace.com/productPage", "wiki_url": null, "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "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": 7350, "name": "3 satellites", "description": "Carried 3 satellites to sun-synchronous orbit, including the Earth observation satellite Jilin-1 Wideband-02B-07. Details TBD.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 89, "url": "https://lldev.thespacedevs.com/2.2.0/pad/89/?format=api", "agency_id": 88, "name": "Haiyang offshore launch location", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=36.631333,121.198361", "latitude": "36.631333", "longitude": "121.198361", "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_89_20200803143242.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 9 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "Aeronautics", "title": "Orienspace Gravity-1 Y2 livestream", "description": "weibo.com/l/wblive/p/show/1022:2321325220255953191263", "feature_image": "https://i.ytimg.com/vi/BIdof29oN8A/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=BIdof29oN8A", "type": { "id": 4, "name": "Unofficial Re-stream" }, "language": { "id": 2, "name": "Chinese", "code": "zn" }, "start_time": "2025-10-11T07:21:08Z", "end_time": "2025-10-11T07:35:31Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7081, "location_launch_attempt_count": 20, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 232, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P270DT23H20M", "mission_patches": [], "type": "detailed" }
