Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/launches/03a60135-c5ce-4c82-845c-e4f7fd2f0299/?format=api
{ "id": "03a60135-c5ce-4c82-845c-e4f7fd2f0299", "url": "https://ll.thespacedevs.com/2.3.0/launches/03a60135-c5ce-4c82-845c-e4f7fd2f0299/?format=api", "name": "PSLV-CA | TeLEOS-1", "response_mode": "detailed", "slug": "pslv-ca-teleos-1", "launch_designator": "2015-077", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T03:54:30Z", "net": "2015-12-16T12:30:00Z", "net_precision": null, "window_end": "2015-12-16T12:30:00Z", "window_start": "2015-12-16T12:30:00Z", "image": { "id": 1807, "name": "[AUTO] PSLV - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20230730102956.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193824.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": -1, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 190, "url": "https://ll.thespacedevs.com/2.3.0/agencies/190/?format=api", "name": "Antrix Corporation Limited", "abbrev": "ACL", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.antrix.co.in/", "wiki_url": "https://en.wikipedia.org/wiki/Antrix_Corporation", "social_media_links": [] }, "rocket": { "id": 1893, "configuration": { "response_mode": "detailed", "id": 43, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/43/?format=api", "name": "PSLV", "families": [ { "response_mode": "detailed", "id": 131, "name": "PSLV", "manufacturer": [ { "response_mode": "normal", "id": 31, "url": "https://ll.thespacedevs.com/2.3.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "abbrev": "ISRO", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" } ], "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", "parent": null, "image": { "id": 14, "name": "[AUTO] Indian Space Research Organization - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184615.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 141, "name": "[AUTO] Indian Space Research Organization - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185007.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 63, "name": "[AUTO] Indian Space Research Organization - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184805.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 1, "failed_landings_payload": 1, "attempted_landings_payload": 2, "info_url": "https://www.isro.gov.in/", "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1993-09-20", "total_launch_count": 62, "consecutive_successful_launches": 21, "successful_launches": 59, "failed_launches": 3, "pending_launches": 4, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "PSLV-CA", "variant": "CA", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 31, "url": "https://ll.thespacedevs.com/2.3.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "abbrev": "ISRO", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" } ], "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", "parent": null, "image": { "id": 14, "name": "[AUTO] Indian Space Research Organization - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184615.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 141, "name": "[AUTO] Indian Space Research Organization - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185007.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 63, "name": "[AUTO] Indian Space Research Organization - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184805.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "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, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 1, "failed_landings_payload": 1, "attempted_landings_payload": 2, "info_url": "https://www.isro.gov.in/", "wiki_url": "http://en.wikipedia.org/wiki/Indian_Space_Research_Organization", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1807, "name": "[AUTO] PSLV - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pslv_image_20230730102956.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193824.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Polar_Satellite_Launch_Vehicle", "description": "The PSLV-CA, CA meaning \"Core Alone\", model premiered on 23 April 2007. The CA model does not include the six strap-on boosters used by the PSLV standard variant. The fourth stage of the CA variant has 400 kg less propellant when compared to its standard version. It currently has capability to launch 1,100 kg to a 622 km Sun synchronous orbit.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 44.0, "diameter": 2.8, "maiden_flight": "2007-04-23", "launch_cost": 16000000, "launch_mass": 230.0, "leo_capacity": 3800.0, "gto_capacity": 1200.0, "geo_capacity": null, "sso_capacity": 1092.0, "to_thrust": 4847.0, "apogee": null, "total_launch_count": 18, "consecutive_successful_launches": 18, "successful_launches": 18, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P73DT11H49M30S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 108, "name": "TeLEOS-1", "type": "Earth Science", "description": "At an altitude of 550km and an inclination of 10-15 degrees, TeLEOS 1 will be Singapore’s first commercial near equatorial orbit satellite. The craft was built by ST Electronics and can image the earth at 1 metre resolutions every 12-16 hours. The satellite weighs 400kg, is powered by 4 solar arrays and has a planned lifetime of 5 years.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 50, "url": "https://ll.thespacedevs.com/2.3.0/pads/50/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 31, "url": "https://ll.thespacedevs.com/2.3.0/agencies/31/?format=api", "name": "Indian Space Research Organization", "abbrev": "ISRO", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" } ], "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", "parent": null, "image": { "id": 14, "name": "[AUTO] Indian Space Research Organization - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_image_20190215225409.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184615.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 141, "name": "[AUTO] Indian Space Research Organization - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_logo_20190215225409.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185007.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 63, "name": "[AUTO] Indian Space Research Organization - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/indian2520space2520research2520organization_nation_20230624125733.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184805.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Satish Dhawan Space Centre First Launch Pad", "image": { "id": 1993, "name": "First Launch Pad", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/first_launch_pa_image_20240311093432.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/first_launch_pa_image_thumbnail_20240311093432.jpeg", "credit": "Indian Space Research Organisation", "license": { "id": 11, "name": "Government Open Data License - India (GODL)", "priority": 3, "link": "https://data.gov.in/sites/default/files/Gazette_Notification_OGDL.pdf" }, "single_use": true, "variants": [] }, "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, "country": { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_50_20200803143457.jpg", "total_launch_count": 61, "orbital_launch_attempt_count": 60, "fastest_turnaround": "P25DT5H56M15S", "location": { "response_mode": "normal", "id": 14, "url": "https://ll.thespacedevs.com/2.3.0/locations/14/?format=api", "name": "Satish Dhawan Space Centre, India", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7147, "successful_launches": 6604, "failed_launches": 543, "total_attempted_landings": 1101, "successful_landings": 1058, "failed_landings": 43 }, "active": true, "country": { "id": 9, "name": "India", "alpha_2_code": "IN", "alpha_3_code": "IND", "nationality_name": "Indian", "nationality_name_composed": "Indo" }, "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.", "image": { "id": 2212, "name": "Satish Dhawan Space Centre", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/satish_dhawan_s_image_20240919164153.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/satish_dhawan_s_image_thumbnail_20240919164154.png", "credit": "ISRO", "license": { "id": 11, "name": "Government Open Data License - India (GODL)", "priority": 3, "link": "https://data.gov.in/sites/default/files/Gazette_Notification_OGDL.pdf" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_14_20200803142403.jpg", "longitude": 80.23, "latitude": 13.72, "timezone_name": "Asia/Kolkata", "total_launch_count": 98, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 5523, "location_launch_attempt_count": 50, "pad_launch_attempt_count": 31, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 81, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 2, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [ { "priority": 0, "source": null, "publisher": null, "title": "The Launch of PSLV-C29/TeLEOS-1 Mission Satellite from SDSC-SHAR -LIVE", "description": "", "feature_image": "https://i.ytimg.com/vi/0NusyXrLmZ4/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=0NusyXrLmZ4", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P79DT8H", "mission_patches": [] }
