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 - ll.thespacedevs.com/docs
GET /2.3.0/launches/ec053d2b-acfc-4cf8-ba16-874bd8533651/?format=api
{ "id": "ec053d2b-acfc-4cf8-ba16-874bd8533651", "url": "https://ll.thespacedevs.com/2.3.0/launches/ec053d2b-acfc-4cf8-ba16-874bd8533651/?format=api", "name": "South Korean ADD Solid-Fuel SLV (3 stage) | S-STEP", "response_mode": "detailed", "slug": "south-korean-add-solid-fuel-slv-3-stage-s-step", "launch_designator": "2023-188", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-05T17:57:31Z", "net": "2023-12-04T05:00:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2023-12-04T05:00:00Z", "window_start": "2023-12-04T05:00:00Z", "image": { "id": 1338, "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png", "credit": "Yonhap", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1079, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "description": "The Agency for Defense Development (ADD) is the South Korean national agency for research and development in defense technology, funded by the Defense Acquisition Program Administration (DAPA). Its purpose is contributing to enforcing the national defence, to improving the national R&D capacity, and to fostering the domestic defense industry.", "administrator": null, "founding_year": 1970, "launchers": "South Korean ADD Solid-Fuel SLV", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "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": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] }, "rocket": { "id": 8142, "configuration": { "response_mode": "detailed", "id": 501, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/501/?format=api", "name": "South Korean ADD Solid-Fuel SLV (3 stage)", "families": [ { "response_mode": "detailed", "id": 146, "name": "South Korean ADD Solid-Fuel SLV", "manufacturer": [ { "response_mode": "normal", "id": 1079, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "description": "The Agency for Defense Development (ADD) is the South Korean national agency for research and development in defense technology, funded by the Defense Acquisition Program Administration (DAPA). Its purpose is contributing to enforcing the national defence, to improving the national R&D capacity, and to fostering the domestic defense industry.", "administrator": null, "founding_year": 1970, "launchers": "South Korean ADD Solid-Fuel SLV", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "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": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2023-12-04", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "South Korean ADD Solid-Fuel SLV (3 stage)", "variant": "", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1079, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1079/?format=api", "name": "Agency for Defense Development", "abbrev": "ADD", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" } ], "description": "The Agency for Defense Development (ADD) is the South Korean national agency for research and development in defense technology, funded by the Defense Acquisition Program Administration (DAPA). Its purpose is contributing to enforcing the national defence, to improving the national R&D capacity, and to fostering the domestic defense industry.", "administrator": null, "founding_year": 1970, "launchers": "South Korean ADD Solid-Fuel SLV", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 105, "name": "[AUTO] Agency for Defense Development - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_logo_20231204144839.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184905.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 36, "name": "[AUTO] Agency for Defense Development - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/agency2520for2520defense2520development_nation_20231204144840.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184722.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "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": "https://www.add.re.kr/eps", "wiki_url": "https://en.wikipedia.org/wiki/Agency_for_Defense_Development", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": null, "description": "", "alias": "", "min_stage": 3, "max_stage": 3, "length": null, "diameter": null, "maiden_flight": "2023-12-04", "launch_cost": null, "launch_mass": null, "leo_capacity": 100.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 6700, "name": "S-STEP", "type": "Earth Science", "description": "Note: Launch vehicle name is provisional.\r\n\r\nPrototype small synthetic-aperture radar (SAR) satellite built by Hanhwa Aerospace on a planar satellite bus. First orbital test launch of the South Korean military small satellite launch vehicle after 2 sub-orbital tests of individual stages on 30 March and 30 December 2022. Does not include planned 2nd stage of the full LV.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 216, "url": "https://ll.thespacedevs.com/2.3.0/pads/216/?format=api", "active": true, "agencies": [], "name": "ADD Offshore launch platform", "image": { "id": 1338, "name": "South Korean ADD Solid-Fuel SLV (3 stage) liftoff (S-STEP)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/south2520korea_image_20231204145331.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192440.png", "credit": "Yonhap", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "Offshore launch platform for the South Korean military small satellite launch vehicle.", "info_url": null, "wiki_url": null, "map_url": null, "latitude": 33.216667, "longitude": 126.366667, "country": { "id": 35, "name": "South Korea", "alpha_2_code": "KR", "alpha_3_code": "KOR", "nationality_name": "South Korean", "nationality_name_composed": "South Korean" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_add_offshore_launch_platform_20231204142359.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1, "fastest_turnaround": null, "location": { "response_mode": "normal", "id": 3, "url": "https://ll.thespacedevs.com/2.3.0/locations/3/?format=api", "name": "Sea Launch", "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": 7149, "successful_launches": 6606, "failed_launches": 543, "total_attempted_landings": 1103, "successful_landings": 1060, "failed_landings": 43 }, "active": true, "country": { "id": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 1418, "name": "Ceres-1S liftoff from DeFu-15002 (4x Tianqi)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_3_20200803142448.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 55, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6565, "location_launch_attempt_count": 46, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 197, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [ { "id": 5864, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://en.yna.co.kr/view/AEN20231204002651315?section=nk/nk", "created_by": "Cosmic_Penguin", "created_on": "2023-12-04T14:26:40Z" } ], "info_urls": [], "vid_urls": [ { "priority": 10, "source": "youtube.com", "publisher": "유용원TV", "title": "우주 공간에서 발사체와 분리되는 국산 소형 SAR 위성! 국내 최초 순수 우리기술로 개발한 지구 관측 위성이 자체 발사와 교신 모두 성공!", "description": "오늘 14시 정각에 발사한 한화시스템의 소형 SAR위성이 목표한 우주궤도에 안착 후 15시 45분 40초에 첫 교신에 성공하고, 방금전인 17시 38분 01초에 용인연구소 지상관제센터와 쌍방교신에 성공했습니다. 이로써 국내 최초 순수 우리기술로 개발한 민간 주도의 상용 지구관측 ...", "feature_image": "https://i.ytimg.com/vi/FL3Pm1_wzhc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=FL3Pm1_wzhc", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2023-12-04T09:04:55Z", "end_time": "2023-12-04T09:06:52Z", "live": false } ], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
