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/b5a9bccb-30d7-4af6-8ad1-fabb563be53c/?format=api
{ "id": "b5a9bccb-30d7-4af6-8ad1-fabb563be53c", "url": "https://ll.thespacedevs.com/2.2.0/launch/b5a9bccb-30d7-4af6-8ad1-fabb563be53c/?format=api", "slug": "pslv-tds-01", "flightclub_url": null, "r_spacex_api_id": null, "name": "PSLV | TDS-01", "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": "2025-04-18T16:11:19Z", "updates": [ { "id": 9796, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q2 2025.", "info_url": "https://www.youtube.com/watch?v=jGsmTUbRWew", "created_by": "Cosmic_Penguin", "created_on": "2025-01-14T07:43:00Z" }, { "id": 9674, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q1.", "info_url": "https://www.youtube.com/watch?v=hkGDfHmiEzA", "created_by": "Cosmic_Penguin", "created_on": "2024-12-30T17:07:00Z" }, { "id": 9008, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET December.", "info_url": "https://www.msn.com/en-in/news/techandscience/isro-to-test-electric-propelled-satellite-in-dec/ar-AA1sYyLf", "created_by": "Cosmic_Penguin", "created_on": "2024-10-26T18:32:00Z" }, { "id": 8344, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2024.", "info_url": "https://www.youtube.com/watch?v=hxzULb53Y6k", "created_by": "Cosmic_Penguin", "created_on": "2024-08-18T00:49:15Z" }, { "id": 6945, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q3 2024.", "info_url": "https://www.inspace.gov.in/sys_attachment.do?sys_id=19a5f4ec8798461082e163d70cbb3571", "created_by": "Cosmic_Penguin", "created_on": "2024-03-12T03:10:12Z" }, { "id": 4494, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting early 2024", "info_url": "https://www.youtube.com/watch?v=VW8BguOnEl4&t=2524s", "created_by": "Nosu", "created_on": "2023-06-29T13:01:48Z" }, { "id": 1761, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch per NOTAM A0255/22. Launch vehicle and payload unconfirmed.", "info_url": null, "created_by": "Nosu", "created_on": "2022-06-01T12:18:00Z" } ], "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": 19, "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": 7595, "configuration": { "id": 7, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/7/?format=api", "name": "PSLV", "active": true, "reusable": false, "description": "The Polar Satellite Launch Vehicle (PSLV) is an expendable medium-lift launch vehicle designed and operated by the Indian Space Research Organisation (ISRO). It was developed to allow India to launch its Indian Remote Sensing (IRS) satellites into sun-synchronous orbits, a service that was, until the advent of the PSLV in 1993, commercially available only from Russia. PSLV can also launch small size satellites into Geostationary Transfer Orbit (GTO).", "family": "PSLV", "full_name": "PSLV", "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": 19, "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": 4, "max_stage": 4, "length": 44.0, "diameter": 2.8, "maiden_flight": "1993-09-20", "launch_cost": "21000000", "launch_mass": 295, "leo_capacity": 3800, "gto_capacity": 1200, "to_thrust": 4847, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20190508083736.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Polar_Satellite_Launch_Vehicle?wprov=sfla1", "total_launch_count": 12, "consecutive_successful_launches": 8, "successful_launches": 10, "failed_launches": 2, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6037, "name": "TDS-01", "description": "TDS-01 (Technology Demonstration Satellite-01) is an Indian geostationary orbit technology demonstration satellite carrying payloads for the Indian Space Research Organisation (ISRO)’s Institute of Plasma Research, Gandhinagar and the CSIR-CEERI, Pilani. \r\n\r\nPayloads to be tested included an internally developed 300 mN electric powered thrusters, atomic clocks, travelling wave tube amplifiers (TWTA) & a quantum communication suite (QuTDS).", "launch_designator": null, "type": "Technology", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 50, "url": "https://ll.thespacedevs.com/2.2.0/pad/50/?format=api", "agency_id": 31, "name": "Satish Dhawan Space Centre First Launch Pad", "description": "India has two launch pads at the site. The First Launch Pad, operational since 1993, is used for Polar Satellite Launch Vehicle, Small Satellite Launch Vehicle and formerly used by Geosynchronous Satellite Launch Vehicle.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Satish_Dhawan_Space_Centre_First_Launch_Pad", "map_url": "https://www.google.com/maps?q=13.733,80.235", "latitude": "13.733", "longitude": "80.235", "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_50_20200803143457.jpg", "total_launch_count": 61, "orbital_launch_attempt_count": 60 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20190508083736.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7113, "location_launch_attempt_count": 110, "pad_launch_attempt_count": 66, "agency_launch_attempt_count": 106, "orbital_launch_attempt_count_year": 264, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 13, "pad_turnaround": "P31D", "mission_patches": [], "type": "detailed" }
