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/880260ab-fba6-4295-b0ce-9b730adb14c3/?format=api
{ "id": "880260ab-fba6-4295-b0ce-9b730adb14c3", "url": "https://ll.thespacedevs.com/2.2.0/launch/880260ab-fba6-4295-b0ce-9b730adb14c3/?format=api", "slug": "soyuz-u-progress-m1-5", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz U | Progress M1-5", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T03:48:30Z", "updates": [], "net": "2001-01-24T04:28:42Z", "net_precision": null, "window_end": "2001-01-24T04:28:42Z", "window_start": "2001-01-24T04:28:42Z", "probability": 0, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "", "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": 10, "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": 2321, "configuration": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/37/?format=api", "name": "Soyuz U", "active": false, "reusable": false, "description": "", "family": "Soyuz", "full_name": "Soyuz U", "manufacturer": { "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": 10, "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" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 51.1, "diameter": 2.95, "maiden_flight": "1973-05-18", "launch_cost": null, "launch_mass": 313, "leo_capacity": 6900, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520u_image_20190222031023.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-U", "total_launch_count": 714, "consecutive_successful_launches": 1, "successful_launches": 694, "failed_launches": 20, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 472, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/472/?format=api", "mission_end": "2001-03-23T05:59:24Z", "destination": "Mir", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 325, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/325/?format=api", "name": "Progress M1-5", "serial_number": "Progress M1-5 (No.254)", "is_placeholder": false, "in_space": false, "time_in_space": "P58DT1H30M42S", "time_docked": "P8847DT20H50M21S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Progress M1-5 (Russian: Прогресс M1-5), was a Progress spacecraft used to deorbit the space station Mir.", "spacecraft_config": { "id": 36, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/36/?format=api", "name": "Progress-M1", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "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", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png" }, "in_use": false, "capability": "ISS Propellant Refueling, Mir Deorbiting", "history": "Progress-M1 is used to resupply space stations. It is a variant of the Progress spacecraft, derived from the Progress-M, but modified to carry more UDMH and N2O4 propellant for refuelling the International Space Station instead of other cargoes such as water.", "details": "Progress is derived from the manned Soyuz spacecraft and is launched on the same vehicle, a Soyuz rocket.\r\nThe purpose of Progress is to deliver supplies needed to sustain human presence in orbit. Currently it is used as a re-supply spacecraft for the ISS.", "maiden_flight": "2000-02-01", "height": 7.23, "diameter": 2.72, "human_rated": false, "crew_capacity": null, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "6 Months docked", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress-m1_image_20231219142545.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Progress-M1", "info_link": "" } }, "landing": { "id": 648, "attempt": false, "success": null, "description": "The Progress spacecraft burned up upon entering Earth's atmosphere.", "downrange_distance": null, "location": null, "type": null }, "docking_events": [ { "id": 386, "spacestation": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/5/?format=api", "name": "Mir", "status": { "id": 2, "name": "De-Orbited" }, "founded": "1986-02-20", "description": "Mir was a space station that operated in low Earth orbit from 1986 to 2001, operated by the Soviet Union and later by Russia. Mir was the first modular space station and was assembled in orbit from 1986 to 1996.\r\n\r\nThe station served as a microgravity research laboratory in which crews conducted experiments in biology, human biology, physics, astronomy, meteorology and spacecraft systems with a goal of developing technologies required for permanent occupation of space.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mir_image_20190218204938.jpeg" }, "docking": "2001-01-27T05:33:31Z", "departure": null, "docking_location": { "id": 6, "name": "Kvant-1 aft", "spacestation": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/5/?format=api", "name": "Mir" } } } ] } }, "mission": null, "pad": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/pad/32/?format=api", "agency_id": null, "name": "1/5", "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=45.92,63.342", "latitude": "45.92", "longitude": "63.342", "location": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1555, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_32_20200803143513.jpg", "total_launch_count": 487, "orbital_launch_attempt_count": 487 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520u_image_20190222031023.jpeg", "infographic": null, "program": [ { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/program/16/?format=api", "name": "Mir", "description": "Mir was a space station that operated in low Earth orbit from 1986 to 2001, operated by the Soviet Union and later by Russia. Mir was the first modular space station and was assembled in orbit from 1986 to 1996.", "agencies": [ { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mir_program_20200821092345.jpeg", "start_date": "1986-02-20T21:28:23Z", "end_date": "2001-03-23T05:59:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Mir", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 4455, "location_launch_attempt_count": 1171, "pad_launch_attempt_count": 369, "agency_launch_attempt_count": 111, "orbital_launch_attempt_count_year": 4455, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P69DT2H56M6S", "mission_patches": [], "type": "detailed" }
