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/220e6d9f-33dc-4533-8a48-535ba4c559e2/?format=api
{ "id": "220e6d9f-33dc-4533-8a48-535ba4c559e2", "url": "https://ll.thespacedevs.com/2.3.0/launches/220e6d9f-33dc-4533-8a48-535ba4c559e2/?format=api", "name": "GSLV | IDRSS-2", "response_mode": "detailed", "slug": "gslv-idrss-2", "launch_designator": null, "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-10-14T06:39:33Z", "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", "image": { "id": 1744, "name": "[AUTO] GSLV Mk II - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520ii_image_20190825171642.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193640.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "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": [] }, "rocket": { "id": 2617, "configuration": { "response_mode": "detailed", "id": 168, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/168/?format=api", "name": "GSLV Mk II", "families": [ { "response_mode": "detailed", "id": 84, "name": "GSLV", "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": "2001-04-18", "total_launch_count": 24, "consecutive_successful_launches": 6, "successful_launches": 18, "failed_launches": 6, "pending_launches": 12, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "GSLV Mk. II", "variant": "", "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": 1744, "name": "[AUTO] GSLV Mk II - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520ii_image_20190825171642.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193640.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/Geosynchronous_Satellite_Launch_Vehicle", "description": "Geosynchronous Satellite Launch Vehicle Mark II (GSLV Mk II) is the largest launch vehicle developed by India, which is currently in operation. This fourth generation launch vehicle is a three stage vehicle with four liquid strap-ons. The indigenously developed cryogenic Upper Stage (CUS), which is flight proven, forms the third stage of GSLV Mk II. From January 2014, the vehicle has achieved four consecutive successes.", "alias": "", "min_stage": 0, "max_stage": 3, "length": 49.0, "diameter": 2.8, "maiden_flight": "2010-04-15", "launch_cost": null, "launch_mass": 401.0, "leo_capacity": 0.0, "gto_capacity": 2500.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": 7420.0, "apogee": 40000.0, "total_launch_count": 11, "consecutive_successful_launches": 3, "successful_launches": 9, "failed_launches": 2, "pending_launches": 6, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P239DT7M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": null, "pad": { "id": 82, "url": "https://ll.thespacedevs.com/2.3.0/pads/82/?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 Second Launch Pad", "image": { "id": 1992, "name": "Second Launch Pad", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/second_launch_p_image_20240311093204.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/second_launch_p_image_thumbnail_20240311093204.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": "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, "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_82_20200803143602.jpg", "total_launch_count": 29, "orbital_launch_attempt_count": 28, "fastest_turnaround": "P31DT31M", "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": 7110, "location_launch_attempt_count": 112, "pad_launch_attempt_count": 38, "agency_launch_attempt_count": 108, "orbital_launch_attempt_count_year": 7110, "location_launch_attempt_count_year": 15, "pad_launch_attempt_count_year": 10, "agency_launch_attempt_count_year": 15, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P153D", "mission_patches": [] }
