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/45f43220-2e7a-4beb-ac60-6b964d35e24b/?format=api
{ "id": "45f43220-2e7a-4beb-ac60-6b964d35e24b", "url": "https://ll.thespacedevs.com/2.2.0/launch/45f43220-2e7a-4beb-ac60-6b964d35e24b/?format=api", "slug": "qaem-100-nahid-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Qaem 100 | Nahid-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-01-20T16:59:08Z", "updates": [ { "id": 6433, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://digitallibrary.un.org/record/4010031?ln=en", "created_by": "Cosmic_Penguin", "created_on": "2024-01-20T16:59:08Z" } ], "net": "2023-03-04T00:00:00Z", "net_precision": { "id": 5, "name": "Day", "abbrev": "DAY", "description": "The T-0 is expected on the given day." }, "window_end": "2023-03-04T00:00:00Z", "window_start": "2023-03-04T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1032, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1032/?format=api", "name": "Islamic Revolutionary Guard Corps Aerospace Force", "featured": false, "type": "Government", "country_code": "IRN", "abbrev": "IRGCAF", "description": "The Islamic Revolutionary Guard Corps Aerospace Force is the strategic missile, air, and space force within the Islamic Revolutionary Guard Corps of Iran. It was renamed from the IRGC Air Force into the IRGC Aerospace Force in 2009.", "administrator": "Brigadier General: Ali Jafarabadi", "founding_year": "1985", "launchers": "Qased", "spacecraft": "", "launch_library_url": null, "total_launch_count": 6, "consecutive_successful_launches": 3, "successful_launches": 5, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Islamic_Revolutionary_Guard_Corps_Aerospace_Force#Space_Command", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/islamic2520revolutionary2520guard2520corps2520aerospace2520force_logo_20220308095207.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/islamic2520revolutionary2520guard2520corps2520aerospace2520force_nation_20220308095207.png" }, "rocket": { "id": 8175, "configuration": { "id": 505, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/505/?format=api", "name": "Qaem 100", "active": true, "reusable": false, "description": "", "family": "", "full_name": "Qaem 100", "manufacturer": { "id": 1032, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1032/?format=api", "name": "Islamic Revolutionary Guard Corps Aerospace Force", "featured": false, "type": "Government", "country_code": "IRN", "abbrev": "IRGCAF", "description": "The Islamic Revolutionary Guard Corps Aerospace Force is the strategic missile, air, and space force within the Islamic Revolutionary Guard Corps of Iran. It was renamed from the IRGC Air Force into the IRGC Aerospace Force in 2009.", "administrator": "Brigadier General: Ali Jafarabadi", "founding_year": "1985", "launchers": "Qased", "spacecraft": "", "launch_library_url": null, "total_launch_count": 6, "consecutive_successful_launches": 3, "successful_launches": 5, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Islamic_Revolutionary_Guard_Corps_Aerospace_Force#Space_Command", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/islamic2520revolutionary2520guard2520corps2520aerospace2520force_logo_20220308095207.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/islamic2520revolutionary2520guard2520corps2520aerospace2520force_nation_20220308095207.png" }, "program": [], "variant": "", "alias": "", "min_stage": 3, "max_stage": 3, "length": null, "diameter": null, "maiden_flight": "2023-03-04", "launch_cost": null, "launch_mass": null, "leo_capacity": 80, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/qaem_100_image_20240123065309.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Qaem_100", "total_launch_count": 3, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6742, "name": "Nahid-1", "description": "Note: Failure officially reported by Israel and not confirmed by Iranian sources.\r\n\r\nNahid 1 (Venus 1) is an Iranian low-earth orbit communications microsatellite. The Iranian Space Agency (ISA) has endorsed a contract with the Iranian Space Research Center to build Nahid 1.", "launch_designator": null, "type": "Communications", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/pad/115/?format=api", "agency_id": null, "name": "Launch Platform", "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=36.200595,55.333939", "latitude": "36.200595", "longitude": "55.333939", "location": { "id": 145, "url": "https://ll.thespacedevs.com/2.2.0/location/145/?format=api", "name": "Shahrud Missile Test Site, Islamic Republic of Iran", "country_code": "IRN", "description": "Shahroud Space Center is a Military Spaceport under control of the Islamic Revolutionary Guard Corps Aerospace Force (IRGCASF) located south-east of Shahroud Semnan Province, used to orbit military satellites for Iran's military space program.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_145_20200803142443.jpg", "timezone_name": "Asia/Tehran", "total_launch_count": 6, "total_landing_count": 0 }, "country_code": "IRN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_115_20200803143303.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 6 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/qaem_100_image_20240123065309.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6399, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 31, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P360DT18H54M", "mission_patches": [], "type": "detailed" }
