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/5d1a96f5-c151-4fbf-9482-1cc3b3fc2f27/?format=api
{ "id": "5d1a96f5-c151-4fbf-9482-1cc3b3fc2f27", "url": "https://ll.thespacedevs.com/2.2.0/launch/5d1a96f5-c151-4fbf-9482-1cc3b3fc2f27/?format=api", "slug": "unha-kwangmyongsong-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "Unha | Kwangmyongsong-4", "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-11-13T17:32:14Z", "updates": [], "net": "2016-02-07T00:30:00Z", "net_precision": null, "window_end": "2016-02-07T00:30:00Z", "window_start": "2016-02-07T00:30:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1074, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1074/?format=api", "name": "National Aerospace Development Administration", "featured": false, "type": "Government", "country_code": "PRK", "abbrev": "NADA", "description": "National Aerospace Development Administration is the official space agency of North Korea, succeeding the Korean Committee of Space Technology (KCST). It was founded on April 1, 2013.", "administrator": null, "founding_year": "2013", "launchers": "Chollima", "spacecraft": "", "launch_library_url": null, "total_launch_count": 5, "consecutive_successful_launches": 0, "successful_launches": 2, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/National_Aerospace_Development_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aerospace2520development2520administration_logo_20230824063913.png", "image_url": null, "nation_url": null }, "rocket": { "id": 1907, "configuration": { "id": 86, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/86/?format=api", "name": "Unha", "active": true, "reusable": false, "description": "", "family": "Taepodong", "full_name": "Unha", "manufacturer": { "id": 40, "url": "https://ll.thespacedevs.com/2.2.0/agencies/40/?format=api", "name": "Korean Committee of Space Technology", "featured": false, "type": "Government", "country_code": "PRK", "abbrev": "KCST", "description": "The Korean Committee of Space Technology was the agency of the government of the Democratic People's Republic of Korea (North Korea) responsible for the country's space program. The agency was terminated and succeeded by the National Aerospace Development Administration in 2013 after the Law on Space Development was passed in the 7th session of the 12th Supreme People's Assembly.", "administrator": null, "founding_year": null, "launchers": "Paektusan | Unha", "spacecraft": "", "launch_library_url": null, "total_launch_count": 4, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/Korean_Committee_of_Space_Technology", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "Unha", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "2009-04-05", "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/unha_image_20190222030930.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Unha", "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "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": 104, "name": "Kwangmyongsong", "description": "Part of North Korea’s Kwangmyongsong (Bright Star) programme, the experimental satellite will attempt to reach orbit.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 74, "url": "https://ll.thespacedevs.com/2.2.0/pad/74/?format=api", "agency_id": 40, "name": "Unha Launch Pad", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Sohae_Satellite_Launching_Station", "map_url": "https://www.google.com/maps?q=39.660065,124.705366", "latitude": "39.660065", "longitude": "124.705366", "location": { "id": 7, "url": "https://ll.thespacedevs.com/2.2.0/location/7/?format=api", "name": "Sohae Satellite Launching Station, Cholsan County, North Pyongan Province, Democratic People's Republic of Korea", "country_code": "PRK", "description": "Sohae Satellite Launching Station is a rocket launching site in Tongch'ang-ri, Cholsan County, North Pyongan Province, North Korea. The base is located among hills close to the northern border with China. The spaceport was built on the site of the village Pongdong-ri which was displaced during construction.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_7_20200803142414.jpg", "timezone_name": "Asia/Pyongyang", "total_launch_count": 7, "total_landing_count": 0 }, "country_code": "PRK", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_74_20200803143358.jpg", "total_launch_count": 3, "orbital_launch_attempt_count": 3 }, "infoURLs": [], "vidURLs": [ { "priority": 9, "source": "youtube.com", "publisher": "Spaceflight101", "title": "North Korea: Successful Launch of Kwangmyongsong-4 Satellite", "description": "Video Credit: Korea Central Television\nAdditional Information: http://spaceflight101.com/north-korea-kms-4-launch-success/\nNorth Korea carried out its controversial space launch Saturday night and suc...", "feature_image": "https://i.ytimg.com/vi/sbgEiUr7OEE/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=sbgEiUr7OEE", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2016-02-07T14:09:01Z", "end_time": "2016-02-07T14:11:58Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Martyn Williams", "title": "KCTV Documentary on Kwangmyongsong 4 launch", "description": "Recorded from Korean Central Television via satellite", "feature_image": "https://i.ytimg.com/vi/izkKpGBMxVA/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=izkKpGBMxVA", "type": { "id": 6, "name": "Recap" }, "language": { "id": 9, "name": "Korean", "code": "ko" }, "start_time": "2016-02-15T21:28:26Z", "end_time": "2016-02-15T22:05:14Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/unha_image_20190222030930.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5538, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 9, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1151DT23H40M14S", "mission_patches": [], "type": "detailed" }
