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/d8103fa8-0a7b-4fcd-89db-03d0c877fa16/?format=api
{ "id": "d8103fa8-0a7b-4fcd-89db-03d0c877fa16", "url": "https://ll.thespacedevs.com/2.3.0/launches/d8103fa8-0a7b-4fcd-89db-03d0c877fa16/?format=api", "name": "Electron | As The Crow Flies (Palisade)", "response_mode": "detailed", "slug": "electron-as-the-crow-flies-palisade", "launch_designator": "2019-069", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-08-02T12:14:51Z", "net": "2019-10-17T01:22:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2019-10-17T03:00:00Z", "window_start": "2019-10-17T00:00:00Z", "image": { "id": 1727, "name": "[AUTO] Electron - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193613.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/electron25202_infographic_20200806035722.png", "probability": -1, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "type": { "id": 3, "name": "Commercial" }, "featured": 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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "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.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "social_media_links": [] }, "rocket": { "id": 2559, "configuration": { "response_mode": "detailed", "id": 26, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/26/?format=api", "name": "Electron", "families": [], "full_name": "Electron", "variant": "", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "type": { "id": 3, "name": "Commercial" }, "featured": 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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "failed_launches": 4, "pending_launches": 33, "consecutive_successful_landings": 4, "successful_landings": 7, "failed_landings": 2, "attempted_landings": 9, "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.rocketlabusa.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1727, "name": "[AUTO] Electron - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193613.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.rocketlabusa.com/electron/", "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Electron", "description": "Electron is a two-stage orbital expendable launch vehicle (with an optional third stage) developed by the American aerospace company Rocket Lab. Electron is a small-lift launch vehicle designed to launch small satellites and cubesats to sun-synchronous orbit and low earth orbit. The Electron is the first orbital class rocket to use electric-pump-fed engines, powered by the 9 Rutherford engines on the first stage. It is also used as a suborbital testbed (called HASTE) for hypersonics research.", "alias": "", "min_stage": 2, "max_stage": 3, "length": 18.0, "diameter": 1.2, "maiden_flight": "2017-05-25", "launch_cost": 6000000, "launch_mass": 13.0, "leo_capacity": 300.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 225.0, "to_thrust": 162.0, "apogee": null, "total_launch_count": 64, "consecutive_successful_launches": 23, "successful_launches": 60, "failed_launches": 4, "pending_launches": 31, "attempted_landings": 9, "successful_landings": 7, "failed_landings": 2, "consecutive_successful_landings": 4, "fastest_turnaround": "PT21H55M" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1042, "name": "As The Crow Flies (Palisade)", "type": "Earth Science", "description": "Encapsulated in Electron's fairing will be a single spacecraft for Astro Digital, a California-based satellite manufacturer and operator. The Landmapper-BC remote sensing satellite features a broad coverage multispectral imaging system with a resolution of 22 meters per pixel. \r\n\r\nEventually, Astro Digital plans to extend the Landmapper-BC constellation to capture daily, multispectral imagery of the world’s arable land.\r\n\r\nThe mission is named 'As The Crow Flies' in a nod to Astro Digital's Corvus Platform, which provides flexible and cost-effective solutions across a wide range of applications and mission profiles on bus variants ranging from 6U and 16U CubeSats to ESPA Class. Corvus is also a widely-distributed genus of birds which includes crows.", "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": 65, "url": "https://ll.thespacedevs.com/2.3.0/pads/65/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "type": { "id": 3, "name": "Commercial" }, "featured": 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": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.", "administrator": "CEO: Peter Beck", "founding_year": 2006, "launchers": "Electron", "spacecraft": "", "parent": null, "image": { "id": 24, "name": "[AUTO] Rocket Lab - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184649.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 176, "name": "[AUTO] Rocket Lab - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185115.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 88, "name": "[AUTO] Rocket Lab - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184840.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Rocket Lab Launch Complex 1A", "image": { "id": 1412, "name": "Electron on LC-1A (Return to Sender)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron25202_image_20201120015105.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192700.jpeg", "credit": "Rocket Lab", "license": { "id": 7, "name": "Rocket Lab Image Use Policy", "priority": 3, "link": "https://www.rocketlabusa.com/about/gallery/" }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Launch_Complex_1", "map_url": "https://www.google.com/maps?q=-39.262833,177.864469", "latitude": -39.262833, "longitude": 177.864469, "country": { "id": 51, "name": "New Zealand", "alpha_2_code": "NZ", "alpha_3_code": "NZL", "nationality_name": "Kiwi", "nationality_name_composed": "Kiwi" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_65_20200803143549.jpg", "total_launch_count": 30, "orbital_launch_attempt_count": 30, "fastest_turnaround": "P20DT22H23M54S", "location": { "response_mode": "normal", "id": 10, "url": "https://ll.thespacedevs.com/2.3.0/locations/10/?format=api", "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand", "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": 7161, "successful_launches": 6618, "failed_launches": 543, "total_attempted_landings": 1110, "successful_landings": 1067, "failed_landings": 43 }, "active": true, "country": { "id": 51, "name": "New Zealand", "alpha_2_code": "NZ", "alpha_3_code": "NZL", "nationality_name": "Kiwi", "nationality_name_composed": "Kiwi" }, "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.", "image": { "id": 2206, "name": "Rocket Lab Launch Complex 1", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_20240918164228.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket_lab_laun_image_thumbnail_20240918164228.jpeg", "credit": "Rocket Lab", "license": { "id": 7, "name": "Rocket Lab Image Use Policy", "priority": 3, "link": "https://www.rocketlabusa.com/about/gallery/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg", "longitude": 177.86586, "latitude": -39.26085, "timezone_name": "Pacific/Auckland", "total_launch_count": 58, "total_landing_count": 17 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 5894, "location_launch_attempt_count": 9, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 9, "orbital_launch_attempt_count_year": 74, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5, "flightclub_url": null, "updates": [], "info_urls": [ { "priority": 10, "source": null, "title": "As The Crow Flies", "description": "This mission is scheduled to take place during a 14-day launch window opening on October 15 NZDT. The mission will lift-off from Rocket Lab Launch Complex 1 on New Zealand’s Māhia Peninsula. Encapsulated in Electron’s fairing will be a single spacecraft for Astro Digital, a California-based satellit...", "feature_image": null, "url": "https://www.rocketlabusa.com/missions/completed-missions/as-the-crow-flies/", "type": null, "language": null } ], "vid_urls": [ { "priority": 0, "source": null, "publisher": null, "title": "As The Crow Flies Launch - 10/17/2019", "description": "Lift-off of the 'As The Crow Flies' mission occurred at 01:22 UTC on October 17 2019 from Rocket Lab Launch Complex 1 on New Zealand's Mahia Peninsula.", "feature_image": "https://i.ytimg.com/vi/gI_Ng4SGyUY/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=gI_Ng4SGyUY", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P58DT13H10M", "mission_patches": [ { "id": 112, "name": "As The Crow Flies Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/as2520the2520_mission_patch_20211031042446.png", "agency": { "response_mode": "list", "id": 147, "url": "https://ll.thespacedevs.com/2.3.0/agencies/147/?format=api", "name": "Rocket Lab", "abbrev": "RL", "type": { "id": 3, "name": "Commercial" } }, "response_mode": "normal" } ] }
