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/2d1a819f-e800-4db2-b4a8-23b77d5f63f7/?format=api
{ "id": "2d1a819f-e800-4db2-b4a8-23b77d5f63f7", "url": "https://ll.thespacedevs.com/2.3.0/launches/2d1a819f-e800-4db2-b4a8-23b77d5f63f7/?format=api", "name": "Black Arrow | X-2", "response_mode": "detailed", "slug": "black-arrow-x-2", "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:29:57Z", "net": "1970-09-02T00:34:05Z", "net_precision": null, "window_end": "1970-09-02T00:34:05Z", "window_start": "1970-09-02T00:34:05Z", "image": { "id": 2012, "name": "Black Arrow in the rocket park at Woomera", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_arrow_in__image_20240314095415.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_arrow_in__image_thumbnail_20240314095416.jpeg", "credit": "artq55", "license": { "id": 18, "name": "CC BY-SA 2.0", "priority": 3, "link": "https://creativecommons.org/licenses/by-sa/2.0/" }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 1005, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1005/?format=api", "name": "Royal Aircraft Establishment", "abbrev": "", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 10, "name": "United Kingdom", "alpha_2_code": "GB", "alpha_3_code": "GBR", "nationality_name": "British", "nationality_name_composed": "Brito" } ], "description": "The Royal Aircraft Establishment (RAE) was a British research establishment, known by several different names during its history, that eventually came under the aegis of the UK Ministry of Defence (MoD), before finally losing its identity in mergers with other institutions.", "administrator": null, "founding_year": 1904, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 1, "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/Royal_Aircraft_Establishment", "social_media_links": [] }, "rocket": { "id": 4044, "configuration": { "response_mode": "detailed", "id": 263, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/263/?format=api", "name": "Black Arrow", "families": [], "full_name": "Black Arrow", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1005, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1005/?format=api", "name": "Royal Aircraft Establishment", "abbrev": "", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 10, "name": "United Kingdom", "alpha_2_code": "GB", "alpha_3_code": "GBR", "nationality_name": "British", "nationality_name_composed": "Brito" } ], "description": "The Royal Aircraft Establishment (RAE) was a British research establishment, known by several different names during its history, that eventually came under the aegis of the UK Ministry of Defence (MoD), before finally losing its identity in mergers with other institutions.", "administrator": null, "founding_year": 1904, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 1, "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/Royal_Aircraft_Establishment", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 2012, "name": "Black Arrow in the rocket park at Woomera", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_arrow_in__image_20240314095415.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_arrow_in__image_thumbnail_20240314095416.jpeg", "credit": "artq55", "license": { "id": 18, "name": "CC BY-SA 2.0", "priority": 3, "link": "https://creativecommons.org/licenses/by-sa/2.0/" }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Black_Arrow", "description": "Black Arrow was a British satellite carrier rocket. Developed during the 1960s, it was used for four launches between 1969 and 1971. Its final flight was the first and only successful orbital launch to be conducted by the United Kingdom, and placed the Prospero satellite into low Earth orbit.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 13.0, "diameter": 2.0, "maiden_flight": "1969-06-27", "launch_cost": null, "launch_mass": 18.0, "leo_capacity": 135.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 256.0, "apogee": null, "total_launch_count": 2, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P421DT3H35M24S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 2462, "name": "X-2", "type": "Test Flight", "description": "Uninstrumented spherical satellite meant to enable atmospheric density measurements by observing its orbital decay. It was destroyed in the failure of the first Black Arrow orbital launch failure.", "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": 179, "url": "https://ll.thespacedevs.com/2.3.0/pads/179/?format=api", "active": true, "agencies": [], "name": "Launch Area 5B", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/RAAF_Woomera_Range_Complex", "map_url": "https://www.google.com/maps?q=-30.9552778,136.5300282", "latitude": -30.9552778, "longitude": 136.5300282, "country": { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_179_20200803143455.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2, "fastest_turnaround": "P421DT3H35M24S", "location": { "response_mode": "normal", "id": 152, "url": "https://ll.thespacedevs.com/2.3.0/locations/152/?format=api", "name": "RAAF Woomera Range Complex", "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": 7162, "successful_launches": 6618, "failed_launches": 544, "total_attempted_landings": 1110, "successful_landings": 1067, "failed_landings": 43 }, "active": true, "country": { "id": 34, "name": "Australia", "alpha_2_code": "AU", "alpha_3_code": "AUS", "nationality_name": "Australian", "nationality_name_composed": "Australo" }, "description": "The RAAF Woomera Range Complex (WRC) is a major Australian military and civil aerospace facility and operation located in South Australia, approximately 450 km (280 mi) north-west of Adelaide. The WRC is operated by the Royal Australian Air Force (RAAF), a Service of the Australian Defence Force (ADF). The complex has a land area of 122,188 km2 (47,177 sq mi) or roughly the size of North Korea or Pennsylvania. The airspace above the area is restricted and controlled by the RAAF for safety and security. The WRC is a highly specialised ADF test and evaluation capability operated by the RAAF for the purposes of testing defence materiel.", "image": { "id": 2208, "name": "Europa I on Launch Area 6A", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/europa_i_on_lau_image_20240918171901.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/europa_i_on_lau_image_thumbnail_20240918171901.jpeg", "credit": "ELDO", "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_152_20200803142502.jpg", "longitude": 136.5322, "latitude": -30.9553, "timezone_name": "Australia/Adelaide", "total_launch_count": 6, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 1122, "location_launch_attempt_count": 5, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 76, "location_launch_attempt_count_year": 2, "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": [] }
