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/18b49918-d2e0-4899-be7a-6c216952b8f3/?format=api
{ "id": "18b49918-d2e0-4899-be7a-6c216952b8f3", "url": "https://ll.thespacedevs.com/2.2.0/launch/18b49918-d2e0-4899-be7a-6c216952b8f3/?format=api", "slug": "kinetica-1-dear-3-10-other-satellites", "flightclub_url": null, "r_spacex_api_id": null, "name": "Kinetica 1 | DEAR-3 & 10 other satellites", "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", "updates": [ { "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" }, { "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": 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": 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" } ], "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", "probability": null, "weather_concerns": null, "holdreason": "", "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": { "id": 1040, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1040/?format=api", "name": "CAS Space", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "CAS", "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": "", "launch_library_url": null, "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, "info_url": "http://cas-space.com/", "wiki_url": "https://en.wikipedia.org/wiki/CAS_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_logo_20220727081352.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_nation_20230604193435.png" }, "rocket": { "id": 8450, "configuration": { "id": 483, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/483/?format=api", "name": "Kinetica 1", "active": true, "reusable": false, "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.", "family": "", "full_name": "Kinetica 1", "manufacturer": { "id": 1040, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1040/?format=api", "name": "CAS Space", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "CAS", "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": "", "launch_library_url": null, "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, "info_url": "http://cas-space.com/", "wiki_url": "https://en.wikipedia.org/wiki/CAS_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_logo_20220727081352.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cas2520space_nation_20230604193435.png" }, "program": [], "variant": "", "alias": "", "min_stage": 4, "max_stage": 4, "length": 30.0, "diameter": 2.65, "maiden_flight": "2022-07-27", "launch_cost": null, "launch_mass": 135, "leo_capacity": 2000, "gto_capacity": null, "to_thrust": 1961, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhongke-1a_image_20220912002218.png", "info_url": "https://en.cas-space.com/index/index/technology", "wiki_url": 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 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7039, "name": "DEAR-3 & 10 other satellites", "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.", "launch_designator": null, "type": "Technology", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 151, "url": "https://ll.thespacedevs.com/2.2.0/pad/151/?format=api", "agency_id": null, "name": "Launch Area 130", "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", "location": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "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).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 248, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_151_20200803143425.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 6 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhongke-1a_image_20220912002218.png", "infographic": null, "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, "pad_turnaround": "P45DT21H31S", "mission_patches": [], "type": "detailed" }
