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/c1d2ea04-0884-4cff-82f6-a7a408e6b5ab/?format=api
{ "id": "c1d2ea04-0884-4cff-82f6-a7a408e6b5ab", "url": "https://ll.thespacedevs.com/2.2.0/launch/c1d2ea04-0884-4cff-82f6-a7a408e6b5ab/?format=api", "slug": "simorgh-unknown", "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": "2024-08-02T16:58:26Z", "updates": [], "net": "2017-07-27T09:30:00Z", "net_precision": null, "window_end": "2017-07-27T09:30:00Z", "window_start": "2017-07-27T09:30:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "Failure due to a problem with the second stage, which failed after 20 seconds of powered flight (of planned 300 seconds).", "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": 2018, "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": 633, "name": "Unknown", "description": "First test flight of the Simorgh rocket, intended to reach orbit. Pentagon officials confirmed the launch occurred at around 9:30 UTC on Thursday and did not place a satellite in orbit.", "launch_designator": null, "type": "Test Flight", "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": [ { "priority": 0, "source": null, "publisher": null, "title": "Iran launches Simorgh satellite carrier from Imam Khomeini Space Center", "description": "The Imam Khomeini National Space Center was officially inaugurated in Iran on Thursday with the successful test-launch of a homegrown satellite carrier dubbe...", "feature_image": "https://i.ytimg.com/vi/elcayxzorbI/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=elcayxzorbI", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "High res footage of Simorgh SLV launch", "description": "Launch from multiple angle shots", "feature_image": "https://i.ytimg.com/vi/UZmrHkNLPd4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=UZmrHkNLPd4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 5661, "location_launch_attempt_count": 8, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 46, "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" }
