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/de282e74-e03b-411e-9633-2d1497629893/?format=api
{ "id": "de282e74-e03b-411e-9633-2d1497629893", "url": "https://ll.thespacedevs.com/2.3.0/launches/de282e74-e03b-411e-9633-2d1497629893/?format=api", "name": "Vanguard | Vanguard", "response_mode": "detailed", "slug": "vanguard-vanguard-4", "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-14T17:42:59Z", "net": "1958-04-29T02:53:00Z", "net_precision": null, "window_end": "1958-04-29T02:53:00Z", "window_start": "1958-04-29T02:53:00Z", "image": { "id": 2067, "name": "Vanguard 1 on Pad LC-18A.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vanguard_1_on_p_image_20240411114304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vanguard_1_on_p_image_thumbnail_20240411114305.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": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 166, "url": "https://ll.thespacedevs.com/2.3.0/agencies/166/?format=api", "name": "US Navy", "abbrev": "USN", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The Navy was competed with the Army to put the first American satellite into orbit. Their first two Vanguard missions failed, with the second being a highly publicized failure, as it exploded on the launchpad. They went on to put 3 satellites into orbit but did not beat the Army to be the first. Their work in space continues today largely on military satellites.", "administrator": null, "founding_year": 1963, "launchers": "", "spacecraft": "Vanguard 1-3 | Parker Solar Probe", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 18, "consecutive_successful_launches": 0, "successful_launches": 3, "failed_launches": 15, "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.navy.mil", "wiki_url": "http://en.wikipedia.org/wiki/US_Navy", "social_media_links": [] }, "rocket": { "id": 3012, "configuration": { "response_mode": "detailed", "id": 449, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/449/?format=api", "name": "Vanguard", "families": [], "full_name": "Vanguard", "variant": "", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 82, "url": "https://ll.thespacedevs.com/2.3.0/agencies/82/?format=api", "name": "Lockheed Martin", "abbrev": "LMT", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "Lockheed Martin's Space Division started in the production of missiles and later ICBM's in the 1950s. Their TITAN missile system was used for 12 Gemini spacecraft and the Voyager probes. They have worked largely in collaboration with NASA on many of their probes, landers, and spacecraft, and hope to play a key role in NASA's return to the moon in 2024.", "administrator": null, "founding_year": 1953, "launchers": "Titan | Agena", "spacecraft": "Hubble | JUNO | InSight", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 80, "consecutive_successful_launches": 38, "successful_launches": 77, "failed_launches": 3, "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.lockheedmartin.com/", "wiki_url": "http://en.wikipedia.org/wiki/Lockheed_Martin", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 2067, "name": "Vanguard 1 on Pad LC-18A.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vanguard_1_on_p_image_20240411114304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vanguard_1_on_p_image_thumbnail_20240411114305.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": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vanguard_(rocket)", "description": "The Vanguard rocket was intended to be the first launch vehicle the United States would use to place a satellite into orbit. Instead, the Sputnik crisis caused by the surprise launch of Sputnik 1 led the U.S., after the failure of Vanguard TV3, to quickly orbit the Explorer 1 satellite using a Juno I rocket, making Vanguard I the second successful U.S. orbital launch.", "alias": "", "min_stage": 3, "max_stage": 3, "length": 23.0, "diameter": 1.14, "maiden_flight": "1957-10-23", "launch_cost": null, "launch_mass": 10.0, "leo_capacity": 9.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 123.0, "apogee": null, "total_launch_count": 11, "consecutive_successful_launches": 1, "successful_launches": 3, "failed_launches": 8, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P29DT53M20S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1432, "name": "Vanguard", "type": "Test Flight", "description": "Small satellite used to test the Vanguard three-stage launch vehicle.", "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": 118, "url": "https://ll.thespacedevs.com/2.3.0/pads/118/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 166, "url": "https://ll.thespacedevs.com/2.3.0/agencies/166/?format=api", "name": "US Navy", "abbrev": "USN", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The Navy was competed with the Army to put the first American satellite into orbit. Their first two Vanguard missions failed, with the second being a highly publicized failure, as it exploded on the launchpad. They went on to put 3 satellites into orbit but did not beat the Army to be the first. Their work in space continues today largely on military satellites.", "administrator": null, "founding_year": 1963, "launchers": "", "spacecraft": "Vanguard 1-3 | Parker Solar Probe", "parent": null, "image": null, "logo": null, "social_logo": null } ], "name": "Launch Complex 18A", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_18", "map_url": "https://www.google.com/maps?q=28.4493,-80.564494", "latitude": 28.4493, "longitude": -80.564494, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_118_20200803143338.jpg", "total_launch_count": 18, "orbital_launch_attempt_count": 11, "fastest_turnaround": "P10DT2H1M6S", "location": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "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": 7140, "successful_launches": 6598, "failed_launches": 542, "total_attempted_landings": 1098, "successful_landings": 1055, "failed_landings": 43 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "image": { "id": 2200, "name": "Cape Canaveral & KSC seen from orbit (STS-43)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "longitude": -80.577778, "latitude": 28.488889, "timezone_name": "America/New_York", "total_launch_count": 1018, "total_landing_count": 64 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 10, "location_launch_attempt_count": 7, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 7, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P42DT14H37M19S", "mission_patches": [] }
