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/4dfd2e8d-8c43-4cd2-944a-85844419e409/?format=api
{ "id": "4dfd2e8d-8c43-4cd2-944a-85844419e409", "url": "https://ll.thespacedevs.com/2.2.0/launch/4dfd2e8d-8c43-4cd2-944a-85844419e409/?format=api", "slug": "simorgh-fakhr-1-saman-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Simorgh | Fakhr-1 & Saman-1", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-12-08T06:02:39Z", "updates": [ { "id": 9439, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success (launch time is per https://orbitalfocus.uk/Diaries/Launches/Launches.php?year=2024#236)", "info_url": "https://www.presstv.ir/Detail/2024/12/06/738576/Iran%E2%80%99s-indigenous-Saman-1-orbital-transfer-block-launched-into-space-aboard-Simorgh-SLV", "created_by": "Cosmic_Penguin", "created_on": "2024-12-06T12:16:00Z" } ], "net": "2024-12-06T03:14:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2024-12-06T03:14:00Z", "window_start": "2024-12-06T03:14:00Z", "probability": null, "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": 8441, "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": 7030, "name": "Fakhr-1 & Saman-1", "description": "Fakhr-1 is a 3U size cubesat to test locally produced spacecraft components, a communication payload and launch vehicle's multi-payload carrying capability. Saman-1 is a prototype solid fuel kick stage with 3-axis control for sending payloads into higher orbits.", "launch_designator": null, "type": "Technology", "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": 6829, "location_launch_attempt_count": 15, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 15, "orbital_launch_attempt_count_year": 240, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P313DT3H10M", "mission_patches": [], "type": "detailed" }
