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/a00842a0-ba6d-486e-a296-429e9943ac44/?format=api
{ "id": "a00842a0-ba6d-486e-a296-429e9943ac44", "url": "https://ll.thespacedevs.com/2.2.0/launch/a00842a0-ba6d-486e-a296-429e9943ac44/?format=api", "slug": "kslv-2-tlv-test-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "KSLV-2-TLV | Test Flight", "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:47:02Z", "updates": [], "net": "2018-11-28T07:00:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2018-11-28T07:00:00Z", "window_start": "2018-11-28T07:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api", "name": "Korea Aerospace Research Institute", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "KARI", "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.", "administrator": "Administrator: Lee Sang-Ryool", "founding_year": "1989", "launchers": "Nuri", "spacecraft": "", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 4, "failed_launches": 3, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.kari.kr/", "wiki_url": "http://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg" }, "rocket": { "id": 8198, "configuration": { "id": 147, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/147/?format=api", "name": "KSLV 2 TLV", "active": false, "reusable": false, "description": "", "family": "KSLV", "full_name": "KSLV 2 TLV", "manufacturer": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api", "name": "Korea Aerospace Research Institute", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "KARI", "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.", "administrator": "Administrator: Lee Sang-Ryool", "founding_year": "1989", "launchers": "Nuri", "spacecraft": "", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 4, "failed_launches": 3, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.kari.kr/", "wiki_url": "http://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg" }, "program": [], "variant": "TLV", "alias": "", "min_stage": 1, "max_stage": 1, "length": null, "diameter": null, "maiden_flight": "2018-11-28", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kslv252022520tlv_image_20190207032613.jpeg", "info_url": null, "wiki_url": 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 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6769, "name": "Test Flight", "description": "Suborbital test flight, reaching a maximum altitude of 209 km and a 151-second burn time", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [ { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/agencies/41/?format=api", "name": "Korea Aerospace Research Institute", "featured": false, "type": "Government", "country_code": "KOR", "abbrev": "KARI", "description": "The Korea Aerospace Research Institute (KARI) established in 1989, is the aeronautics and space agency of Republic of Korea. Its main laboratories are located in Daejeon, in the Daedeok Science Town.", "administrator": "Administrator: Lee Sang-Ryool", "founding_year": "1989", "launchers": "Nuri", "spacecraft": "", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 4, "failed_launches": 3, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.kari.kr/", "wiki_url": "http://en.wikipedia.org/wiki/Korea_Aerospace_Research_Institute", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_logo_20200806032236.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/korea2520aerospace2520research2520institute_nation_20230604194037.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 192, "url": "https://ll.thespacedevs.com/2.2.0/pad/192/?format=api", "agency_id": 41, "name": "LC-2", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Naro_Space_Center", "map_url": "https://www.google.com/maps?q=34.431867,127.535069", "latitude": "34.431867", "longitude": "127.535069", "location": { "id": 9, "url": "https://ll.thespacedevs.com/2.2.0/location/9/?format=api", "name": "Naro Space Center, South Korea", "country_code": "KOR", "description": "The Naro Space Center is a South Korean spaceport in South Jeolla's Goheung County, operated by the state-run Korea Aerospace Research Institute.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_9_20200803142441.jpg", "timezone_name": "Asia/Seoul", "total_launch_count": 7, "total_landing_count": 0 }, "country_code": "KOR", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_lc-2_20210812070305.jpg", "total_launch_count": 4, "orbital_launch_attempt_count": 3 }, "infoURLs": [], "vidURLs": [ { "priority": 9, "source": "youtube.com", "publisher": "한국항공우주연구원 KARI TV", "title": "[KARI] 시험발사체 정상적으로 발사!", "description": "시험발사체 정상적으로 발사!발사 장면을 영상으로 공개합니다.", "feature_image": "https://i.ytimg.com/vi/RZqYctjqokc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=RZqYctjqokc", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-11-28T07:37:01Z", "end_time": "2018-11-28T07:40:03Z" }, { "priority": 11, "source": "youtube.com", "publisher": "SciNews", "title": "KSLV-II first test flight", "description": "Korea Aerospace Research Institute (KARI) launched KSLV-II TLV, the first test flight for Korea Space Launch Vehicle-2 (KSLV-II), on 28 November 2018, at 07:...", "feature_image": "https://i.ytimg.com/vi/vDYfTE0o4mY/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=vDYfTE0o4mY", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-11-28T10:17:28Z", "end_time": "2018-11-28T10:21:49Z" }, { "priority": 12, "source": "youtube.com", "publisher": "한국항공우주연구원 KARI TV", "title": "[4K] 시험발사체 발사 미공개 영상 공개", "description": "시험발사체 발사 영상 중 미처 공개하지 못한 영상을 4K로 공개합니다", "feature_image": "https://i.ytimg.com/vi/ilr3INYkD1E/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=ilr3INYkD1E", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-11-29T05:59:23Z", "end_time": "2018-11-29T06:00:00Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kslv-2-tlv2520_image_20240217134241.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
