Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__agency__ids, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/launches/57d675d1-9a50-4c62-bee0-915c8c26befe/?format=api
{ "id": "57d675d1-9a50-4c62-bee0-915c8c26befe", "url": "https://lldev.thespacedevs.com/2.3.0/launches/57d675d1-9a50-4c62-bee0-915c8c26befe/?format=api", "name": "Gravity-1 | 3 satellites", "response_mode": "detailed", "slug": "gravity-1-3-satellites", "launch_designator": "2025-226", "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", "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", "image": { "id": 1355, "name": "Gravity-1 liftoff from Haiyang Spaceport (Maiden flight)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192513.jpeg", "credit": "OrienSpace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1080, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1080/?format=api", "name": "Orienspace Technology", "abbrev": "OrienSpace", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "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": "", "parent": null, "image": null, "logo": { "id": 168, "name": "[AUTO] Orienspace Technology - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_logo_20240112075736.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185058.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 82, "name": "[AUTO] Orienspace Technology - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_nation_20240112075637.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184832.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.orienspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orienspace", "social_media_links": [] }, "rocket": { "id": 8759, "configuration": { "response_mode": "detailed", "id": 503, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/503/?format=api", "name": "Gravity-1", "families": [], "full_name": "Gravity-1", "variant": "Gravity-1", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1080, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1080/?format=api", "name": "Orienspace Technology", "abbrev": "OrienSpace", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "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": "", "parent": null, "image": null, "logo": { "id": 168, "name": "[AUTO] Orienspace Technology - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_logo_20240112075736.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185058.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 82, "name": "[AUTO] Orienspace Technology - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orienspace2520technology_nation_20240112075637.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184832.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "https://www.orienspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Orienspace", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1742, "name": "[AUTO] Gravity-1 - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-1_image_20240108105446.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193637.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.orienspace.com/productPage", "wiki_url": null, "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.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 29.4, "diameter": null, "maiden_flight": "2024-01-11", "launch_cost": null, "launch_mass": 405.0, "leo_capacity": 6500.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 4200.0, "to_thrust": 5880.0, "apogee": 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, "fastest_turnaround": "P638DT20H50M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 7350, "name": "3 satellites", "type": "Earth Science", "description": "Carried 3 satellites to sun-synchronous orbit, including the Earth observation satellite Jilin-1 Wideband-02B-07. Details TBD.", "image": null, "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 89, "url": "https://lldev.thespacedevs.com/2.3.0/pads/89/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": 1999, "launchers": "Long March", "spacecraft": "", "parent": null, "image": { "id": 8, "name": "[AUTO] China Aerospace Science and Technology Corporation - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184558.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 124, "name": "[AUTO] China Aerospace Science and Technology Corporation - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184933.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 50, "name": "[AUTO] China Aerospace Science and Technology Corporation - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184746.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Haiyang offshore launch location", "image": { "id": 1418, "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192712.jpeg", "credit": "CASC", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "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, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_89_20200803143242.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 9, "fastest_turnaround": "P25DT21H9M", "location": { "response_mode": "normal", "id": 185, "url": "https://lldev.thespacedevs.com/2.3.0/locations/185/?format=api", "name": "Haiyang Oriental Spaceport", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7470, "successful_launches": 6915, "failed_launches": 555, "total_attempted_landings": 1288, "successful_landings": 1241, "failed_landings": 47 }, "active": true, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "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.", "image": { "id": 1355, "name": "Gravity-1 liftoff from Haiyang Spaceport (Maiden flight)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-12520_image_20240112065126.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192513.jpeg", "credit": "OrienSpace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "longitude": 121.235103, "latitude": 36.676794, "timezone_name": "Asia/Shanghai", "total_launch_count": 24, "total_landing_count": 0 } }, "webcast_live": false, "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, "flightclub_url": null, "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" } ], "info_urls": [], "vid_urls": [ { "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", "live": false } ], "timeline": [], "pad_turnaround": "P270DT23H20M", "mission_patches": [] }
