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/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api
{ "id": "a8c191e1-b231-4b2e-aefd-5e8ad55c7a82", "url": "https://ll.thespacedevs.com/2.3.0/launches/a8c191e1-b231-4b2e-aefd-5e8ad55c7a82/?format=api", "name": "Miura 5 | Maiden Flight", "response_mode": "detailed", "slug": "miura-5-maiden-flight", "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-02-25T13:40: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", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1051, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "abbrev": "PLD Space", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" } ], "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": 2011, "launchers": "Miura 1 | Miura 5", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 169, "name": "[AUTO] Payload Aerospace S.L. - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185100.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 83, "name": "[AUTO] Payload Aerospace S.L. - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184833.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "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.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "social_media_links": [] }, "rocket": { "id": 8207, "configuration": { "response_mode": "detailed", "id": 509, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/509/?format=api", "name": "Miura 5", "families": [ { "response_mode": "detailed", "id": 120, "name": "Miura", "manufacturer": [ { "response_mode": "normal", "id": 1051, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "abbrev": "PLD Space", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" } ], "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": 2011, "launchers": "Miura 1 | Miura 5", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 169, "name": "[AUTO] Payload Aerospace S.L. - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185100.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 83, "name": "[AUTO] Payload Aerospace S.L. - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184833.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "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.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2023-10-07", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Miura 5", "variant": "", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1051, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "abbrev": "PLD Space", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" } ], "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": 2011, "launchers": "Miura 1 | Miura 5", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 169, "name": "[AUTO] Payload Aerospace S.L. - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185100.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 83, "name": "[AUTO] Payload Aerospace S.L. - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184833.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "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.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "social_media_links": [] }, "program": [], "reusable": true, "image": null, "info_url": "https://www.pldspace.com/en/miura-5", "wiki_url": "https://en.wikipedia.org/wiki/Miura_5", "description": "MIURA 5 is a 2 stage launch vehicle powered by liquid oxygen and kerosene. The vehicle is designed,\r\nintegrated and operated by PLD Space, and its 1st stage is designed to be eventually recovered by parachuting into the sea.", "alias": "", "min_stage": 2, "max_stage": 3, "length": 35.81, "diameter": 2.0, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 900.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 540.0, "to_thrust": 950.0, "apogee": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": null }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 6779, "name": "Maiden Flight", "type": "Test Flight", "description": "First flight of the Miura 5 launch vehicle.", "image": null, "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [ { "response_mode": "normal", "id": 1051, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1051/?format=api", "name": "Payload Aerospace S.L.", "abbrev": "PLD Space", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 7, "name": "Spain", "alpha_2_code": "ES", "alpha_3_code": "ESP", "nationality_name": "Spanish", "nationality_name_composed": "Hispano" } ], "description": "Payload Aerospace S.L. is a Spanish company developing two partially-reusable launch vehicles called Miura 1 and Miura 5.", "administrator": "CEO: Raúl Torres", "founding_year": 2011, "launchers": "Miura 1 | Miura 5", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 169, "name": "[AUTO] Payload Aerospace S.L. - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._logo_20230530095525.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185100.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 83, "name": "[AUTO] Payload Aerospace S.L. - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/payload2520aerospace2520s.l._nation_20230530104423.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184833.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "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.pldspace.com/en/", "wiki_url": "https://en.wikipedia.org/wiki/PLD_Space", "social_media_links": [] } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 125, "url": "https://ll.thespacedevs.com/2.3.0/pads/125/?format=api", "active": false, "agencies": [ { "response_mode": "normal", "id": 115, "url": "https://ll.thespacedevs.com/2.3.0/agencies/115/?format=api", "name": "Arianespace", "abbrev": "ASA", "type": { "id": 3, "name": "Commercial" }, "featured": true, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" } ], "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": 1980, "launchers": "Ariane | Vega", "spacecraft": "", "parent": "ArianeGroup", "image": { "id": 1692, "name": "Ariane 62 on ELA-4 (Maiden Flight)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_thumbnail_20240708201808.jpeg", "credit": "ESA/L. Bourgeon", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "logo": { "id": 108, "name": "Arianespace blue logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184909.png", "credit": "Arianespace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [ { "id": 11, "type": { "id": 1, "name": "transparent for light background" }, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianespace_log_image_20250211184850.png" }, { "id": 12, "type": { "id": 2, "name": "transparent for dark background" }, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/image_variants/arianespace_log_image_20250211184853.png" } ] }, "social_logo": { "id": 39, "name": "Arianespace social logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184728.jpeg", "credit": "Arianespace", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Diamant Launch Area", "image": null, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=5.2222222,-52.7758051", "latitude": 5.2222222, "longitude": -52.7758051, "country": { "id": 50, "name": "French Guiana", "alpha_2_code": "GF", "alpha_3_code": "GUF", "nationality_name": "French Guianan", "nationality_name_composed": "Franco-Guiano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8, "fastest_turnaround": "P99DT17H57M", "location": { "response_mode": "normal", "id": 13, "url": "https://ll.thespacedevs.com/2.3.0/locations/13/?format=api", "name": "Guiana Space Centre, French Guiana", "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": 50, "name": "French Guiana", "alpha_2_code": "GF", "alpha_3_code": "GUF", "nationality_name": "French Guianan", "nationality_name_composed": "Franco-Guiano" }, "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "image": { "id": 2203, "name": "Vega & Ariane 5 pads at the Guiana Space Centre", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_2526_aria_image_20240918154413.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_2526_aria_image_thumbnail_20240918154414.jpeg", "credit": "ESA/S. Corvaja", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "longitude": -52.6903, "latitude": 5.169, "timezone_name": "America/Cayenne", "total_launch_count": 325, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 7110, "location_launch_attempt_count": 343, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 261, "location_launch_attempt_count_year": 20, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [ { "id": 6801, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://europeanspaceflight.com/esa-awards-e1-3m-in-co-funding-to-pld-for-miura-5-payload-adapter/", "created_by": "Cosmic_Penguin", "created_on": "2024-02-25T13:40:35Z" } ], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P18357DT15H23M", "mission_patches": [] }
