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/ca680864-788f-4096-93e2-c09f1b2193c9/?format=api
{ "id": "ca680864-788f-4096-93e2-c09f1b2193c9", "url": "https://ll.thespacedevs.com/2.2.0/launch/ca680864-788f-4096-93e2-c09f1b2193c9/?format=api", "slug": "lvm-3-gaganyaan-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "LVM-3 | Gaganyaan-2", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-06-02T09:19:33Z", "updates": [ { "id": 7704, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2025.", "info_url": "https://www.business-standard.com/india-news/isro-to-have-second-trial-flight-of-unmanned-gaganyaan-mission-today-124042400356_1.html", "created_by": "Cosmic_Penguin", "created_on": "2024-06-02T09:19:34Z" } ], "net": "2025-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2025-12-31T00:00:00Z", "window_start": "2025-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 31, "url": "https://ll.thespacedevs.com/2.2.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "featured": true, "type": "Government", "country_code": "IND", "abbrev": "ISRO", "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"", "administrator": "Chairman: V. Narayanan", "founding_year": "1969", "launchers": "PSLV | GSLV", "spacecraft": "Gaganyaan", "launch_library_url": null, "total_launch_count": 94, "consecutive_successful_launches": 16, "successful_launches": 81, "failed_launches": 13, "pending_launches": 18, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.isro.gov.in/", "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg" }, "rocket": { "id": 7523, "configuration": { "id": 172, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/172/?format=api", "name": "LVM-3 (GSLV Mk III)", "active": true, "reusable": false, "description": "The Launch Vehicle Mark-3 (LVM-3), previously called Geosynchronous Satellite Launch Vehicle Mark III (GSLV Mk III), is a three-stage medium-lift launch vehicle developed by the Indian Space Research Organisation (ISRO). It is designed to launch satellites into geostationary orbit, and is intended as a launch vehicle for crewed missions under the Indian Human Spaceflight Programme.", "family": "GSLV", "full_name": "Launch Vehicle Mark-3 (GSLV Mk III)", "manufacturer": { "id": 31, "url": "https://ll.thespacedevs.com/2.2.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "featured": true, "type": "Government", "country_code": "IND", "abbrev": "ISRO", "description": "The Indian Space Research Organisation (ISRO) is the space agency of the Government of India headquartered in the city of Bangalore. Its vision is to \"harness space technology for national development while pursuing space science research and planetary exploration.\"", "administrator": "Chairman: V. Narayanan", "founding_year": "1969", "launchers": "PSLV | GSLV", "spacecraft": "Gaganyaan", "launch_library_url": null, "total_launch_count": 94, "consecutive_successful_launches": 16, "successful_launches": 81, "failed_launches": 13, "pending_launches": 18, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.isro.gov.in/", "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 0, "max_stage": 3, "length": 43.4, "diameter": 4.0, "maiden_flight": "2014-12-18", "launch_cost": "46000000", "launch_mass": 629, "leo_capacity": 10000, "gto_capacity": 5000, "to_thrust": 11898, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520iii_image_20190604000938.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Geosynchronous_Satellite_Launch_Vehicle", "total_launch_count": 7, "consecutive_successful_launches": 7, "successful_launches": 7, "failed_launches": 0, "pending_launches": 6, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 771, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/771/?format=api", "mission_end": null, "destination": "Low Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 548, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/548/?format=api", "name": "Gaganyaan G2", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Second operational Gaganyaan capsule.", "spacecraft_config": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/29/?format=api", "name": "Gaganyaan", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 1031, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1031/?format=api", "name": "Hindustan Aeronautics Limited", "featured": false, "type": "Government", "country_code": "IND", "abbrev": "HAL", "description": "Hindustan Aeronautics Limited is an Indian state-owned aerospace and defence company, headquartered in Bengaluru, India. Established on 23 December 1940, HAL is one of the oldest and largest aerospace and defence manufacturers in the world.", "administrator": "Chairman: R. Madhavan", "founding_year": "1940", "launchers": "", "spacecraft": "Gaganyaan", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hindustan_aeron_image_20220205093649.png", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hindustan2520aeronautics2520limited_logo_20220205093649.png" }, "in_use": true, "capability": "The spacecraft is being designed to carry three people, and a planned upgraded version will be equipped with rendezvous and docking capability.", "history": "This Hindustan Aeronautics Limited manufactured crew module had its first uncrewed experimental flight on 18 December 2014 as part of a suborbital test flight of the GSLV Mark III rocket.", "details": "Gaganyaan is an Indian crewed orbital spacecraft intended to be the formative spacecraft of the Indian Human Spaceflight Programme.", "maiden_flight": "2023-10-21", "height": 3.58, "diameter": 3.5, "human_rated": true, "crew_capacity": 3, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Up to seven days in orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_image_20231021132705.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Gaganyaan", "info_link": "https://www.isro.gov.in/frequently-asked-questions/gaganyaan" } }, "landing": { "id": 453, "attempt": true, "success": null, "description": "The Gaganyaan spacecraft will splashdown in the Bay of Bengal after this flight.", "downrange_distance": null, "location": { "id": 31, "name": "Bay of Bengal", "abbrev": "BB", "description": "Northeastern part of the Indian Ocean.", "location": null, "successful_landings": 0 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 5941, "name": "Gaganyaan-2", "description": "Second uncrewed orbital test flight of the Gaganyaan capsule.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 82, "url": "https://ll.thespacedevs.com/2.2.0/pad/82/?format=api", "agency_id": 31, "name": "Satish Dhawan Space Centre Second Launch Pad", "description": "The second launch pad was built between 1999 and 2003. It became functional in 2005 and has since been used for various rockets. This launch pad supports missions by PSLV, GSLV, LVM3 rockets and is even envisioned for India's future crewed spaceflight.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_Second_Launch_Pad", "map_url": "https://www.google.com/maps?q=13.7199,80.2304", "latitude": "13.7199", "longitude": "80.2304", "location": { "id": 14, "url": "https://ll.thespacedevs.com/2.2.0/location/14/?format=api", "name": "Satish Dhawan Space Centre, India", "country_code": "IND", "description": "Satish Dhawan Space Centre – SDSC (formerly Sriharikota Range – SHAR),[1] is the primary spaceport of the Indian Space Research Organisation (ISRO), located in Sriharikota, Andhra Pradesh.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg", "timezone_name": "Asia/Kolkata", "total_launch_count": 98, "total_landing_count": 0 }, "country_code": "IND", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_82_20200803143602.jpg", "total_launch_count": 29, "orbital_launch_attempt_count": 28 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520iii_image_20190604000938.jpg", "infographic": null, "program": [ { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/program/21/?format=api", "name": "Gaganyaan", "description": "Gaganyaan is India's first human spaceflight program.", "agencies": [ { "id": 31, "url": "https://ll.thespacedevs.com/2.2.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_program_20220120151540.jpg", "start_date": "2018-08-15T00:00:00Z", "end_date": null, "info_url": "https://www.isro.gov.in/frequently-asked-questions/gaganyaan", "wiki_url": "https://en.wikipedia.org/wiki/Gaganyaan", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 7104, "location_launch_attempt_count": 112, "pad_launch_attempt_count": 38, "agency_launch_attempt_count": 108, "orbital_launch_attempt_count_year": 255, "location_launch_attempt_count_year": 15, "pad_launch_attempt_count_year": 10, "agency_launch_attempt_count_year": 15, "pad_turnaround": "P153D", "mission_patches": [], "type": "detailed" }
