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/335aae0f-3c89-4ab8-a446-7078222220b3/?format=api
{ "id": "335aae0f-3c89-4ab8-a446-7078222220b3", "url": "https://ll.thespacedevs.com/2.2.0/launch/335aae0f-3c89-4ab8-a446-7078222220b3/?format=api", "slug": "simorgh-3-unknown-payloads", "flightclub_url": null, "r_spacex_api_id": null, "name": "Simorgh | 3 unknown payloads", "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:06Z", "updates": [], "net": "2021-12-30T03:30:00Z", "net_precision": null, "window_end": "2021-12-30T03:30:00Z", "window_start": "2021-12-30T03:30:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "Although official reports by Iran call this a successful launch, no objects have been detected in orbit. The general consensus is that it was a failed orbital launch attempt.", "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": 7502, "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": 5912, "name": "3 unknown payloads", "description": "Three unknown research payloads are reported to have been sent into space, according to the Iranian Ministry of Defense. However, no new objects are being tracked in the orbit after this launch attempt so it is considered a failure despite Iran's reports of success.", "launch_designator": null, "type": "Unknown", "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": 6182, "location_launch_attempt_count": 13, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 145, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P201DT3H30M", "mission_patches": [], "type": "detailed" }
