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__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/18b49918-d2e0-4899-be7a-6c216952b8f3/?format=api
{ "id": "18b49918-d2e0-4899-be7a-6c216952b8f3", "url": "https://lldev.thespacedevs.com/2.3.0/launches/18b49918-d2e0-4899-be7a-6c216952b8f3/?format=api", "name": "Kinetica 1 | DEAR-3 & 10 other satellites", "response_mode": "detailed", "slug": "kinetica-1-dear-3-10-other-satellites", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2025-01-23T13:12:56Z", "net": "2024-12-27T01:03:31Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-12-27T01:16:00Z", "window_start": "2024-12-27T00:53:00Z", "image": { "id": 1755, "name": "[AUTO] Kinetica 1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhongke-1a_image_20220912002218.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193659.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "3rd stage loss of attitude control 3 seconds after ignition due to damage of the power supply wire to the 3rd stage motor Thrust Vector Control (TVC) mechanism during installation, then subsequent breaking due to vibration while in powered flight.", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1040, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1040/?format=api", "name": "CAS Space", "abbrev": "CAS", "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": "CAS Space is a spin-off company from the Chinese Academy of Sciences (CAS) that is operating and plans to operate various launch vehicles of the Zhongke series.", "administrator": null, "founding_year": 2018, "launchers": "Zhongke", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 122, "name": "[AUTO] CAS Space - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_logo_20220727081352.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184930.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 48, "name": "[AUTO] CAS Space - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_nation_20230604193435.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184743.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 5, "failed_launches": 1, "pending_launches": 0, "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": "http://cas-space.com/", "wiki_url": "https://en.wikipedia.org/wiki/CAS_Space", "social_media_links": [] }, "rocket": { "id": 8450, "configuration": { "response_mode": "detailed", "id": 483, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/483/?format=api", "name": "Kinetica 1", "families": [], "full_name": "Kinetica 1", "variant": "", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1040, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1040/?format=api", "name": "CAS Space", "abbrev": "CAS", "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": "CAS Space is a spin-off company from the Chinese Academy of Sciences (CAS) that is operating and plans to operate various launch vehicles of the Zhongke series.", "administrator": null, "founding_year": 2018, "launchers": "Zhongke", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 122, "name": "[AUTO] CAS Space - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_logo_20220727081352.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184930.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 48, "name": "[AUTO] CAS Space - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_nation_20230604193435.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184743.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 5, "failed_launches": 1, "pending_launches": 0, "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": "http://cas-space.com/", "wiki_url": "https://en.wikipedia.org/wiki/CAS_Space", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1755, "name": "[AUTO] Kinetica 1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhongke-1a_image_20220912002218.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193659.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://en.cas-space.com/index/index/technology", "wiki_url": null, "description": "Kinetica 1 (also known as Lijian-1, Chinese: 力箭一号) is a Chinese solid-propellant light launch vehicle. It is capable of placing about 2 tons into low earth orbit and 1.5 tons into sun-synchronous orbit. It is developed by CAS Space, a subsidiary of the Chinese Academy of Sciences. Kinetica 1 is a light launcher whose first stage seems to be derived from the DF-31 long-range intercontinental ballistic missile. It is 30 m high and has a diameter of 2.65 m, with a liftoff mass of 135 t. It's the largest Chinese solid propellant launcher to date, with four stages with a thrust of 200, 100, 50 and 10 tons respectively. The fairing has a diameter of 3.35 meters.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 30.0, "diameter": 2.65, "maiden_flight": "2022-07-27", "launch_cost": null, "launch_mass": 135.0, "leo_capacity": 2000.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 1500.0, "to_thrust": 1961.0, "apogee": null, "total_launch_count": 6, "consecutive_successful_launches": 0, "successful_launches": 5, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P45DT21H31S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 7039, "name": "DEAR-3 & 10 other satellites", "type": "Technology", "description": "Launched 11 satellites including AZSPACE's DEAR-3 prototype recoverable science experiment spacecraft and the French CASAA-Sat cubesat from the Marseille Astrophysics Laboratory.", "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": 151, "url": "https://lldev.thespacedevs.com/2.3.0/pads/151/?format=api", "active": true, "agencies": [], "name": "Launch Area 130", "image": { "id": 1460, "name": "Kinetica 1 liftoff from LA-130 (Flight 2)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kinetica25201_image_20230727064618.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192832.jpeg", "credit": "CAS Space", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=40.8182,100.22514", "latitude": 40.8182, "longitude": 100.22514, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_151_20200803143425.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 6, "fastest_turnaround": "P45DT21H31S", "location": { "response_mode": "normal", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "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-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": 7134, "successful_launches": 6592, "failed_launches": 542, "total_attempted_landings": 1093, "successful_landings": 1050, "failed_landings": 43 }, "active": true, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "image": { "id": 1374, "name": "Long March 2F/G liftoff (Shenzhou 16)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg", "credit": "CMS", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "longitude": 100.291111, "latitude": 40.958056, "timezone_name": "Asia/Shanghai", "total_launch_count": 247, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6845, "location_launch_attempt_count": 239, "pad_launch_attempt_count": 6, "agency_launch_attempt_count": 6, "orbital_launch_attempt_count_year": 256, "location_launch_attempt_count_year": 21, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 4, "flightclub_url": null, "updates": [ { "id": 9614, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Adding launch per NOTAMs; Payload and launch vehicle identities uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2650276#msg2650276", "created_by": "Cosmic_Penguin", "created_on": "2024-12-21T11:52:00Z" }, { "id": 9629, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET December 27.", "info_url": "https://x.com/cas_space/status/1871161929382957303", "created_by": "Cosmic_Penguin", "created_on": "2024-12-23T13:33:00Z" }, { "id": 9643, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff confirmed; launch may have failed, confirmation pending.", "info_url": "https://live.douyin.com/283138284042", "created_by": "Cosmic_Penguin", "created_on": "2024-12-27T01:36:00Z" }, { "id": 9644, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch failure confirmed.", "info_url": "https://x.com/cas_space/status/1872493468934873284", "created_by": "Cosmic_Penguin", "created_on": "2024-12-27T04:14:00Z" } ], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P45DT21H31S", "mission_patches": [] }
