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/2facca07-91fc-435b-aeb7-953cac57fdee/?format=api
{ "id": "2facca07-91fc-435b-aeb7-953cac57fdee", "url": "https://ll.thespacedevs.com/2.2.0/launch/2facca07-91fc-435b-aeb7-953cac57fdee/?format=api", "slug": "simorgh-unknown-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Simorgh | Unknown", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T04:17:05Z", "updates": [ { "id": 603, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Added launch. Details such as launch time or payload were not available, but will be updated if they become known.", "info_url": "https://edition.cnn.com/2021/06/22/politics/iran-failed-satellite-launch/index.html", "created_by": "spacevogel", "created_on": "2021-06-23T06:05:10Z" } ], "net": "2021-06-12T00:00:00Z", "net_precision": null, "window_end": "2021-06-12T00:00:00Z", "window_start": "2021-06-12T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Failure was reported per US government sources, however the details were not made public.", "hashtag": null, "launch_service_provider": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/agencies/34/?format=api", "name": "Iranian Space Agency", "featured": false, "type": "Government", "country_code": "IRN", "abbrev": "ISA", "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.", "administrator": "Administrator: Hassan Salarieh", "founding_year": "2004", "launchers": "Safir | Simorgh", "spacecraft": "", "launch_library_url": null, "total_launch_count": 15, "consecutive_successful_launches": 2, "successful_launches": 6, "failed_launches": 9, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.isa.ir/", "wiki_url": "http://en.wikipedia.org/wiki/Iranian_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg", "image_url": null, "nation_url": null }, "rocket": { "id": 2960, "configuration": { "id": 142, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/142/?format=api", "name": "Simorgh", "active": true, "reusable": false, "description": "", "family": "", "full_name": "Simorgh", "manufacturer": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/agencies/34/?format=api", "name": "Iranian Space Agency", "featured": false, "type": "Government", "country_code": "IRN", "abbrev": "ISA", "description": "The Iranian Space Agency is Iran's governmental space agency. Iran became an orbital-launch-capable nation in 2009. Iran is one of the 24 founding members of the United Nations Committee on the Peaceful Uses of Outer Space, which was set up in 1958.", "administrator": "Administrator: Hassan Salarieh", "founding_year": "2004", "launchers": "Safir | Simorgh", "spacecraft": "", "launch_library_url": null, "total_launch_count": 15, "consecutive_successful_launches": 2, "successful_launches": 6, "failed_launches": 9, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.isa.ir/", "wiki_url": "http://en.wikipedia.org/wiki/Iranian_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/iranian2520space2520agency_logo_20200422091550.jpg", "image_url": null, "nation_url": null }, "program": [], "variant": "", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "2017-07-27", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Simorgh_(rocket)", "total_launch_count": 7, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 5, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1382, "name": "Unknown", "description": "According to U.S. Space Command, Iran suffered a rocket launch failure early on June 12th. While there are no details available as to which rocket was used, what the payload was or how exactly the launch had failed, OSINT efforts suggest that the launcher used was the Simorgh rocket. This makes it a fourth consecutive failure of the Simorgh launch vehicle.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 88, "url": "https://ll.thespacedevs.com/2.2.0/pad/88/?format=api", "agency_id": 34, "name": "Imam Khomeini Spaceport", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Imam_Khomeini_Spaceport", "map_url": "https://www.google.com/maps?q=35.237005,53.9505", "latitude": "35.237005", "longitude": "53.9505", "location": { "id": 2, "url": "https://ll.thespacedevs.com/2.2.0/location/2/?format=api", "name": "Semnan Space Center, Islamic Republic of Iran", "country_code": "IRN", "description": "Semnan Space Center is the primary Iranian spaceport, located 50 km southeast of the city of Semnan in the north of the country.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_2_20200803142458.jpg", "timezone_name": "Asia/Tehran", "total_launch_count": 15, "total_landing_count": 0 }, "country_code": "IRN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_88_20200803143310.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 6090, "location_launch_attempt_count": 12, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 12, "orbital_launch_attempt_count_year": 53, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P488DT8H15M", "mission_patches": [], "type": "detailed" }
