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/8fd1e2cf-5a1e-4514-b17a-aecaf95f7c2e/?format=api
{ "id": "8fd1e2cf-5a1e-4514-b17a-aecaf95f7c2e", "url": "https://ll.thespacedevs.com/2.2.0/launch/8fd1e2cf-5a1e-4514-b17a-aecaf95f7c2e/?format=api", "slug": "soyuz-21avolga-mikhailo-lomonosov-aist-2d-samsat-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz-2.1a/Volga | Mikhailo Lomonosov, Aist-2D & SamSat 218", "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-06-15T13:48:29Z", "updates": [], "net": "2016-04-28T02:01:21Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2016-04-28T02:01:21Z", "window_start": "2016-04-28T02:01:21Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "RFSA", "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": "1992", "launchers": "Soyuz", "spacecraft": "Soyuz", "launch_library_url": null, "total_launch_count": 331, "consecutive_successful_launches": 55, "successful_launches": 320, "failed_launches": 11, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://en.roscosmos.ru/", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 1923, "configuration": { "id": 57, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/57/?format=api", "name": "Soyuz 2.1a/Volga", "active": true, "reusable": false, "description": "In addition to the switch to digital flight control systems as part of the Soyuz 2.1A, this version utilizes the Volga upper stage.", "family": "Soyuz", "full_name": "Soyuz 2.1a Volga", "manufacturer": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/agencies/111/?format=api", "name": "Progress Rocket Space Center", "featured": false, "type": "Commercial", "country_code": "RUS", "abbrev": "PRSC", "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.", "administrator": "CEO: Dmitry Baranov", "founding_year": "1996", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 45, "consecutive_successful_launches": 3, "successful_launches": 44, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://en.samspace.ru/", "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "Volga", "alias": "", "min_stage": 2, "max_stage": 3, "length": 19.6, "diameter": 2.68, "maiden_flight": "2004-11-08", "launch_cost": "80000000", "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": 4149, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2", "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": 145, "name": "Mikhailo Lomonosov, Aist-2D & SamSat 218", "description": "MVL-300 is named after Mikhail Vasilyevich Lomonosov to honour the 300th year since his birth. The Russian mission will study transient phenomena in the Earth’s upper atmosphere, as well as observing cosmic rays and gamma ray bursts. With a short lifespan of 5 years, the 450kg craft will operate in a 550km Sun-Synchronous orbit.This will mark the first Soyuz mission to launch from the Vostochny Cosmodrome, Russia", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 83, "url": "https://ll.thespacedevs.com/2.2.0/pad/83/?format=api", "agency_id": 63, "name": "Cosmodrome Site 1S", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome", "map_url": "https://www.google.com/maps?q=51.884395,128.333932", "latitude": "51.884395", "longitude": "128.333932", "location": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/location/18/?format=api", "name": "Vostochny Cosmodrome, Siberia, Russian Federation", "country_code": "RUS", "description": "The Vostochny Cosmodrome is a Russian spaceport above the 51st parallel north in the Amur Oblast, in the Russian Far East. It is intended to reduce Russia's dependency on the Baikonur Cosmodrome in Kazakhstan. The first launch took place on 28 April 2016 at 02:01 UTC.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg", "timezone_name": "Asia/Yakutsk", "total_launch_count": 19, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg", "total_launch_count": 18, "orbital_launch_attempt_count": 18 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Первый пуск с Восточного. Видео с бортовых камер.", "description": "Видео первого пуска с космодрома Восточный с бортовых камер ракеты-носителя «Союз-2.1а». Пуск состоялся 28 апреля 2016 года.", "feature_image": "https://i.ytimg.com/vi/Q-FltpndeIs/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Q-FltpndeIs", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Космодром Восточный. Пуск РКН Союз-2.1а.", "description": "28 апреля 2016 года в 5:01 мск с первого гражданского космодрома России - космодрома Восточный - проведен первый пуск ракеты-носителя «Союз-2.1а» с космическ...", "feature_image": "https://i.ytimg.com/vi/b-1AoE4R4w8/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=b-1AoE4R4w8", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 5555, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 256, "orbital_launch_attempt_count_year": 26, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
