Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/767f7827-53d8-4621-803b-f456a1e6b512/?format=api
{ "id": "767f7827-53d8-4621-803b-f456a1e6b512", "url": "https://lldev.thespacedevs.com/2.0.0/launch/767f7827-53d8-4621-803b-f456a1e6b512/?format=api", "launch_library_id": null, "slug": "gravity-1-spacesail-polar-group-16", "name": "Gravity-1 | SpaceSail Polar Group #16", "status": { "id": 3, "name": "Success" }, "net": "2026-09-15T22:00:00Z", "window_end": "2026-09-15T22:11:00Z", "window_start": "2026-09-15T21:50:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1080, "url": "https://lldev.thespacedevs.com/2.0.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": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "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": 9133, "configuration": { "id": 503, "launch_library_id": null, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/503/?format=api", "name": "Gravity-1", "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.0.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": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "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_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": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7732, "launch_library_id": null, "name": "SpaceSail Polar Group #16", "description": "9 Low Earth Orbit communication satellites with Ku, Q and V band payloads for the G60 constellation operated by Shanghai Spacesail Technologies with funding backed by the Shanghai local government.\r\n\r\nInitial constellation will consist of 1296 satellites by 2027 with long term plans to expand it to 12000 satellites.", "launch_designator": null, "type": "Communications", "orbit": { "id": 13, "name": "Polar Orbit", "abbrev": "PO" } }, "pad": { "id": 255, "url": "https://lldev.thespacedevs.com/2.0.0/pad/255/?format=api", "agency_id": 88, "name": "Yellow Sea (launch location 5)", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=31.2,123.7", "latitude": "31.2", "longitude": "123.7", "location": { "id": 185, "url": "https://lldev.thespacedevs.com/2.0.0/location/185/?format=api", "name": "Haiyang Oriental Spaceport", "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "total_launch_count": 29, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_yellow_sea_2528launch_location_52529_20260716051255.jpg", "total_launch_count": 2 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gravity-1_image_20240108105446.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7392, "location_launch_attempt_count": 28, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 219, "location_launch_attempt_count_year": 7, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
