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/15183b48-9462-4eb7-b24e-eb6286605bb1/?format=api
{ "id": "15183b48-9462-4eb7-b24e-eb6286605bb1", "url": "https://ll.thespacedevs.com/2.3.0/launches/15183b48-9462-4eb7-b24e-eb6286605bb1/?format=api", "name": "VLS-1 | SCD-2A", "response_mode": "detailed", "slug": "vls-1-scd-2a", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T04:25:22Z", "net": "1997-11-02T12:25:00Z", "net_precision": null, "window_end": "1997-11-02T12:25:00Z", "window_start": "1997-11-02T12:25:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/agencies/12/?format=api", "name": "Brazilian Space Agency", "abbrev": "AEB", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 24, "name": "Brazil", "alpha_2_code": "BR", "alpha_3_code": "BRA", "nationality_name": "Brazilian", "nationality_name_composed": "Brazilian" } ], "description": "The Brazilian Space Agency is a space agency in South America. They work in partnership with the US and Russia aboard the ISS. It was previously operated by the military until 1994. They now operate largely in tandem with other nations. They run a spaceport and rocket launch site both in Brazil. They built the VLM small satellite launch system in tandem with Germany. The VLS-1 was intended to be a primary launch vehicle for the BSA, but it failed 3 times and was canceled. They have restarted work on the system in tandem with the Russian Space Agency.", "administrator": "Administrator: Marco Antonio Chamon", "founding_year": 1961, "launchers": "VLM | VLS", "spacecraft": "None", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 2, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 2, "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.aeb.gov.br/", "wiki_url": "http://en.wikipedia.org/wiki/Brazilian_Space_Agency", "social_media_links": [] }, "rocket": { "id": 6814, "configuration": { "response_mode": "detailed", "id": 448, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/448/?format=api", "name": "VLS-1", "families": [], "full_name": "VLS-1", "variant": "1", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1012, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1012/?format=api", "name": "Department of Aerospace Science and Technology", "abbrev": "", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 24, "name": "Brazil", "alpha_2_code": "BR", "alpha_3_code": "BRA", "nationality_name": "Brazilian", "nationality_name_composed": "Brazilian" } ], "description": "The Brazilian Department of Science and Aerospace Technology is the national military research center for aviation and space flight. It is subordinated to the Brazilian Air Force (FAB). It coordinates all technical and scientific activities related to the aerospace sector in which there are interests by the Ministry of Defence. It was established in 1953. It currently employs several thousand civilian and military personnel.", "administrator": null, "founding_year": 1953, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Department_of_Aerospace_Science_and_Technology", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/VLS-1", "description": "The VLS-1 was the Brazilian Space Agency's main satellite launch vehicle. The launch vehicle was to be capable of launching satellites into orbit. The launch site was located at the Alcântara Launch Center due to its proximity to the equator.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 19.5, "diameter": 1.01, "maiden_flight": "1997-11-02", "launch_cost": null, "launch_mass": 50.0, "leo_capacity": 120.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 1172.0, "apogee": null, "total_launch_count": 2, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P769DT6H" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5204, "name": "SCD-2A", "type": "Communications", "description": "The satellites of the SCD (Satelites de Coleta de Dados) series are equipped to collect and transmit meteorological and environmental data collected by automatic platforms (PCD) installed on land or on oceanic buoys. The data is relayed to one or more ground stations.", "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": 146, "url": "https://ll.thespacedevs.com/2.3.0/pads/146/?format=api", "active": true, "agencies": [], "name": "VLS Pad", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Alc%C3%A2ntara_Launch_Center", "map_url": "https://www.google.com/maps?q=-2.3177,-44.369984", "latitude": -2.3177, "longitude": -44.369984, "country": { "id": 24, "name": "Brazil", "alpha_2_code": "BR", "alpha_3_code": "BRA", "nationality_name": "Brazilian", "nationality_name_composed": "Brazilian" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_146_20200803143337.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2, "fastest_turnaround": "P769DT6H", "location": { "response_mode": "normal", "id": 150, "url": "https://ll.thespacedevs.com/2.3.0/locations/150/?format=api", "name": "Alcântara Space Center, Federative Republic of Brazil", "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": 7156, "successful_launches": 6613, "failed_launches": 543, "total_attempted_landings": 1108, "successful_landings": 1065, "failed_landings": 43 }, "active": true, "country": { "id": 24, "name": "Brazil", "alpha_2_code": "BR", "alpha_3_code": "BRA", "nationality_name": "Brazilian", "nationality_name_composed": "Brazilian" }, "description": "The Alcântara Space Center, formerly known as Alcântara Launch Center is a space center and launching facility of the Brazilian Space Agency in the city of Alcântara, located on Brazil's northern Atlantic coast, in the state of Maranhão.", "image": { "id": 2136, "name": "VLS Pad at the Alcântara Space Center", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vls_pad_at_the__image_20240808093113.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vls_pad_at_the__image_thumbnail_20240808093114.jpeg", "credit": "AEB", "license": { "id": 27, "name": "CC BY-ND 3.0", "priority": 0, "link": "https://creativecommons.org/licenses/by-nd/3.0/deed.en" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_150_20200803142405.jpg", "longitude": -44.4175, "latitude": -2.339444, "timezone_name": "America/Fortaleza", "total_launch_count": 2, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4187, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 69, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P0D", "mission_patches": [] }
