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/8695499e-9a59-4673-8519-d162e52984c4/?format=api
{ "id": "8695499e-9a59-4673-8519-d162e52984c4", "url": "https://ll.thespacedevs.com/2.2.0/launch/8695499e-9a59-4673-8519-d162e52984c4/?format=api", "slug": "simorgh-zafar-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Simorgh | Zafar-1", "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:54:13Z", "updates": [], "net": "2020-02-09T15:45:00Z", "net_precision": null, "window_end": "2020-02-09T15:45:00Z", "window_start": "2020-02-09T15:45:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "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": 2658, "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": 1082, "name": "Zafar-1", "description": "Zafar-1 is a small Earth observation satellite with reported ground resolution of 22.5 m. This is also a third attempt for Simorgh rocket to conduct a successful launch.", "launch_designator": null, "type": "Earth Science", "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": 5932, "location_launch_attempt_count": 11, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 11, "orbital_launch_attempt_count_year": 10, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P390DT15H15M", "mission_patches": [], "type": "detailed" }
